预约会议

更新时间: 2026/01/06 15:49:38

本文介绍如何通过网易会议组件预约会议,并进行预约会议的管理,包括编辑预约会议、取消预约会议、查询预约会议信息、查询指定状态下的预约会议列表。

前提条件

根据本文操作前,请确保您已经完成了 登录鉴权

预约会议

在已经完成 SDK 登录鉴权的状态下,预约一个新的会议。

调用 scheduleMeeting 方法预约会议并进行回调处理,您可根据错误码判断接口是否调用成功。

  • 该接口仅支持 在登录鉴权成功后调用,其他情况下会调用失败。
  • 预约会议时,scheduleMeeting 接口中的参数 NEMeetingItem,必须是 createScheduleMeetingItem 返回的 NEMeetingItem 对象。

示例代码 如下:

Objective-CNEMeetingItem *meetingItem =
      [[NEMeetingKit getInstance].getPreMeetingService createScheduleMeetingItem];

  [meetingItem setSubject:@"会议主题"];            // 预约会议主题
  [meetingItem setStartTime:"int64_t startTime"];  // 预约会议开始时间
  [meetingItem setEndTime:"int64_t endTime"];      // 预约会议结束时间

  [[NEMeetingKit getInstance].getPreMeetingService
      scheduleMeeting:meetingItem
             callback:^(NSInteger resultCode, NSString *_Nonnull resultMsg,
                        NEMeetingItem *_Nullable item) {
               if (resultCode == ERROR_CODE_SUCCESS) {
                 // code
               }
             }];

编辑预约会议

在已经完成 SDK 登录鉴权的状态下,编辑一个已经预约的会议。

调用 editMeeting 方法编辑会议并进行回调处理,您可根据错误码判断接口是否调用成功。

该接口仅支持 在登录鉴权成功后调用,其他情况下会调用失败。

示例代码 如下:

Objective-C[meetingItem setSubject:@"新的会议主题"];
  [[NEMeetingKit getInstance].getPreMeetingService
               editMeeting:meetingItem
      editRecurringMeeting:false
                  callback:^(NSInteger resultCode, NSString *_Nonnull resultMsg,
                             NEMeetingItem *_Nullable item) {
                    if (resultCode == ERROR_CODE_SUCCESS) {
                      // code
                    }
                  }];

取消预约会议

在已经完成 SDK 登录鉴权的状态下,取消一个已经预约的会议。

调用 cancelMeeting 方法取消预约会议并进行回调处理,您可根据错误码判断接口是否调用成功。

  • 该接口仅支持 在登录鉴权成功后调用,其他情况下会调用失败。
  • 取消预约会议时,cancelMeeting 接口中的参数 meetingId 是服务端返回的唯一码,请从 NEMeetingItem#getMeetingId 处获取。
  • 您无法取消正在进行中的、处于回收状态的或已经结束的会议。

示例代码 如下:

Objective-C[[NEMeetingKit getInstance].getPreMeetingService
               cancelMeeting:meetingId
      cancelRecurringMeeting:false
                    callback:^(NSInteger resultCode, NSString *resultMessage) {
                      if (resultCode == ERROR_CODE_SUCCESS) {
                        // code
                      }
                    }];

查询预约会议信息

在已经完成 SDK 登录鉴权的状态下,查询一个已经预约的会议的信息。

调用 getMeetingItemByNum 方法查询预约会议信息并进行回调处理,您可根据错误码判断接口是否调用成功。

  • 该接口仅支持 在登录鉴权成功后调用,其他情况下会调用失败。
  • 查询预约会议的信息时,getMeetingItemByNum 接口中的参数 meetingNum 是服务端返回的会议号,请从 NEMeetingItem#getMeetingNum 处获取。

示例代码 如下:

Objective-C[[NEMeetingKit getInstance].getPreMeetingService
      getMeetingItemByNum:meetingNum
                 callback:^(NSInteger resultCode, NSString *_Nonnull resultMsg,
                            NEMeetingItem *_Nullable item) {
                   if (resultCode == ERROR_CODE_SUCCESS) {
                     // code
                   }
                 }];

查询指定状态下的预约会议列表

在已经完成 SDK 登录鉴权的状态下,根据指定的一种或多种会议状态在已预约的所有会议基础上筛选出会议列表。

调用 getMeetingList 方法查询指定状态下的预约会议列表并进行回调处理,您可根据错误码判断接口是否调用成功。

  • 该接口仅支持 在登录鉴权成功后调用,其他情况下会调用失败。
  • 调用此接口时,默认返回最近一周的指定会议列表。

示例代码 如下:

Objective-CNSArray *meetingStatus =
      @[ @(NEMeetingItemStatusInit), @(NEMeetingItemStatusStarted), @(NEMeetingItemStatusEnded) ];
  [[NEMeetingKit getInstance].getPreMeetingService
      getMeetingList:meetingStatus
            callback:^(NSInteger resultCode, NSString *_Nonnull resultMsg,
                       NSArray<NEMeetingItem *> *_Nonnull items) {
              if (resultCode == ERROR_CODE_SUCCESS) {
                // code
              }
            }];

监听预约会议状态

通过注册预约会议状态回调接口,获取预约会议状态变更的通知。

  1. 注册回调接口 addListener 开始监听,并在回调方法中根据您的需求处理相应事件。

    • 该接口在初始化 SDK 成功后即可调用。
    • 一次会议状态变更回调可能包含多个会议信息的变更。

    示例代码 如下:

    Objective-C@interface AppVC () <NEPreMeetingListener>
    @end
    
    @implementation AppVC
    
    - (void)viewDidLoad {
            [super viewDidLoad];
            [[NEMeetingKit getInstance].getPreMeetingService addListener:self];
        }
    
    - (void)onMeetingItemInfoChanged:(NSArray<NEMeetingItem *> *)meetingItemList {
        
    }
    @end
    
  2. 反注册回调接口 removeListener 停止监听。

    示例代码 如下:

    Objective-C@interface AppVC () <NEPreMeetingListener>
    @end
    
    @implementation AppVC
    
    - (void)dealloc {
            [[NEMeetingKit getInstance].getPreMeetingService removeListener:self];
        }
    
    - (void)onMeetingItemInfoChanged:(NSArray<NEMeetingItem *> *)meetingItemList {
        
    }
    @end
    
此文档是否对你有帮助?
有帮助
去反馈
  • 前提条件
  • 预约会议
  • 编辑预约会议
  • 取消预约会议
  • 查询预约会议信息
  • 查询指定状态下的预约会议列表
  • 监听预约会议状态