华为云用户手册

业务流程 接口调用 创建入会参数JoinConfParam。 会议id加入会议使用PasswordJoinConfParam。 会议random加入会议使用RandomJoinConfParam。 1 2 3 4 5 6 7 //加入会议对象 PasswordJoinConfParam passwordJoinConfParam = new PasswordJoinConfParam() .setConfId(getConfId()) //加入会议ID .setNickname(getNickname()) //设置昵称 .setCameraOn(true) //是否开启摄像头 .setMicOn(true); //是否开启麦克风 .setPassword(true) //入会密码 调用joinConf接口加入会议，第1步中的数据作为参数。 处理回调 处理回调中的结果。

业务流程 使用SDK预约会议前，处理用户界面输入的预约会议信息，调用bookConf接口，然后处理回调hwmCallback和 消息通知 BizNotificationHandler的onConfListChanged。 接口调用 组装数据结构BookConfParam。 调用bookConf开始创建预约会议，第1步中的数据作为参数。 处理回调函数 处理回调函数hwmCallback。 处理消息通知 处理消息通知onConfListChanged。

业务流程 接口调用 创建登录参数AppIdAuthParam。 设置第三方账号的唯一标识。 设置随机字符串。 设置签名信息。 设置该用户所在的企业ID,仅SP模式下需要填写 设置签名过期时间。 设置登录账号的昵称。 设置登录账号的邮箱。 设置登录账号的手机号码。 调用loginByAppid接口进行登录，第1步中的数据作为参数，会议服务器会根据相关参数，如果没有开户则执行开户。 处理回调 处理回调中的结果。

注意事项，使用前必看 需要使用通知方法时，必须注册代理对象。 两种方式： 初始化时，对HWMOpenSDKConfig对象的属性赋值 1 2 3 HWMOpenSDKConfig *config = [[HWMOpenSDKConfig alloc] init]; //示例根据需求使用对应代理 config.globalHandler = [NotifyMessageHandler sharedInstance]; 使用前使用[HWMSdk getSdkConfig]获取初始化对象给属性赋值 1 2 //示例根据需求使用对应代理 [HWMSdk getSdkConfig].globalHandler = [NotifyMessageHandler sharedInstance]; 代理方法必须写在代理对象中 使用代理时保证代理对象存在

SDK概述 华为云会议服务为开发者提供Windows、Android、iOS、Mac、Electron、Web的客户端SDK，方便开发者将华为云会议的音频会议、视频会议、桌面共享能力快速集成到自己的应用中。 华为云会议的客户端SDK已经实现了会议中UI界面，包括会场画面显示，会议控制功能，桌面共享等，开发者只需要调用少量接口即可完成华为云会议能力的集成。客户端SDK已经提供的主要UI如下（以Windows SDK为例，其他平台的SDK能力相同，只是界面布局有差异。Web客户端SDK的能力差异较大，详细功能点对比请参考“Android/iOS/Windows/Mac/Web SDK功能对比”）。 会议中的主界面 图1 会中主界面 桌面共享界面 图2 桌面共享界面 会议来电界面 图3 会议来电界面 来电通知界面只有在应用进程没有被系统终止的情况下才能收到来电通知，移动端SDK并不提供VoIP Push能力。 Web端只能主动加入会议，不能被邀请加入会议。 Android/iOS/Windows/Mac/Web SDK功能对比如下： 表1 Android/iOS/Windows/Mac/Web SDK功能对比 分类 功能项 Windows Mac Android iOS Web桌面版 备注 会议管理 会议预约 √ √ √ √ x 接口 创建立即会议 √ √ √ √ x 接口 编辑会议 √ √ √ √ x 接口 取消会议 √ √ √ √ x 接口 会议列表 √ √ √ √ x 接口 查询会议详情 √ √ √ √ x 接口 查询云会议室 √ √ √ √ x 接口 修改云会议室信息 √ √ √ √ x 接口 加入会议 通过会议ID加入会议 √ √ √ √ √ 接口 通过会议链接（Random码）加入会议 √ √ √ √ √ 接口 被邀加入会议 √ √ √ √ x UI 与会者会控 自己麦克风静音 √ √ √ √ √ UI 自己扬声器闭音 √ √ √ √ √ UI 音频设备切换 √ √ √ √ √ UI 摄像头切换 √ √ √ √ √ UI 修改会场名称 √ √ √ √ √ UI 举手 √ √ √ √ √ UI 选看 √ √ √ √ √ UI 离开会议 √ √ √ √ √ UI 主持人会控 全场静音 √ √ √ √ √ UI 静音其他与会者 √ √ √ √ √ UI 移除与会者 √ √ √ √ √ UI 转移主持人 √ √ √ √ √ UI 结束会议 √ √ √ √ √ UI 启动录制 √ √ √ √ √ UI 锁定会议 √ √ √ √ √ UI 锁定共享 √ √ √ √ √ UI 广播单画面 √ √ √ √ √ UI 广播多画面 √ x x x x UI 设置联席主持人 √ √ √ √ x UI 画面布局 桌面：演讲者模式 √ √ - - √ UI 桌面：画廊模式 25画面 25画面 - - 6画面 UI 桌面：画中画模式 √ √ - - x UI 移动：大画面 - - √ √ - UI 移动：均分画面 - - √ √ - UI 语音激励 √ √ √ √ √ UI 视频分辨率 发送最高分辨率 1080P（默认720P） 720P（默认360P） 720P 720P 360P UI 接收最高分辨率 1080P（默认720P） 720P（默认360P） 720P 720P 720P UI 桌面共享分辨率 发送最高分辨率 4K 1080P 4K 4K 1080P UI 接收最高分辨率 4K 1080P 4K 4K 1080P UI 会议共享 发起屏幕共享 √ √ √ √ √ UI 观看屏幕共享 √ √ √ √ √ UI 发起白板共享 √ √ x x x UI 观看白板共享 √ √ √ √ √ UI 发起程序共享 √ √ x x √ UI 观看程序共享 √ √ √ √ √ UI 标注 √ √ √ √ x UI 远程控制 √ √ x x x UI 聊天 聊天窗口 √ √ √ √ √ UI 弹幕 √ √ √ √ √ UI 点对点通话 视频通话 √ √ √ √ x UI 音频通话 √ x √ √ x UI 其他 美颜 √ x √ √ x UI 虚拟背景 √ √ √ √ x UI 语音会议 √ √ √ √ x UI AI字幕 √ √ x x x UI Web SDK仅支持桌面版（Windows和Mac的Chrome浏览器和Safari浏览器），不支持手机版（Android和iOS）。 集成Web SDK时如果需要使用“会议管理”功能，请在服务后台调用服务端API的“会议管理”接口。 Electron SDK的功能与Windows和Mac SDK功能相同。

第三方客户端调用Exit接口，需要等待一段时间后才能退出 客户案例： 某客户集成了会议Win SDK，客户应用退出后，发现会议进程仍在运行，exit回调时间很长。 原因分析： 该客户在logout的回调里面调用exit接口，exit接口要等待logout的回调结束才能销毁资源，logout的回调在等exit退出，造成线程死锁，导致如上现象。 正确方案： 在logout回调结束后，再调用exit接口，详见下图。点击查看更多接口调用时序图。 图1 接口调用时序图 父主题： Windows SDK

方法定义 1 - (NSView *)socialShareView:(HWMConfStateInfo *)confInfo; 示例代码 - (NSView *)socialShareView:(HWMConfStateInfo *)confDetail { if (!self.socialView) { self.socialView = [[HWMSocialView alloc] initWithFrame:NSMakeRect(0, 0, 500, 300)]; self.socialView.wantsLayer = YES; self.socialView.layer.backgroundColor = [NSColor whiteColor].CGColor; } self.socialView.confDetail = confDetail; return self.socialView; } 表1 参数说明 参数 类型 描述 confInfo HWMConfStateInfo * 会中会议状态详情 表2 HWMConfStateInfo 说明 参数 类型 描述 confId NSString * 会议id。 confSubject NSString * 会议主题。 chairmanPwd NSString * 主持人密码。 generalPwd NSString * 来宾密码。 startTimeStamp NSInteger 会议开始时间，UTC时间戳，精度秒。 endTimeStamp NSInteger 会议开始时间，UTC时间戳，精度秒。 videoConf BOOL 是否是视频会议。 confScheduleName NSString * 预订者姓名。 chairJoinUri NSString * 主持人加入会议uri链接。 guestJoinUri NSString * 普通与会者加入会议uri链接。 vmrConferenceId NSString * VMR会议显示ID。 role HWMConfRoleType 角色。 orgId NSString * 会议所属的企业id。用户判断是否是外部人员入会，登录结果中有个corpId上报，登录的企业ID与会议的企业ID不是一个，说明为外部。 customInfo NSString * 自定义信息（会议详情、会中消息推送可以查看）

参数描述 表1 参数说明 参数 类型 描述 thirdAccount NSString * appid登录场景下优先使用此字段。 account NSString * 账号 密码登录场景下 优先使用此字。 number NSString * 跨企业场景优先使用此字段。 completionBlock void(^)(NSError *_Nullable error, NSString *_Nullable headImagePath) 结果回调。

方法定义 1 - (void)downloadHeadPortraitWithThirdAccount:(NSString *)thirdAccount account:(NSString *)account number:(nonnull NSString *)number completionBlock:(void(^)(NSError *_Nullable error, NSString *_Nullable headImagePath))completionBlock;

方法定义 1 virtual void OnQueryContactAvatar(const char account[HWM_MAX_ACCOUNT_LEN], const char thirdUserId[HWM_MAX_ACCOUNT_LEN], const char sipNumber[HWM_MAX_NUMBER_LEN], char* avatarPath,int pathLen) {};

参数描述 表1 参数 类型 描述 account char[] 登录华为云会议的账号信息。 thirdUserId char[] 登录华为云会议的第三方用户Id。 sipNumber char[] 账号对应的sip号码。 avatarPath char* 查询通讯录返回的头像路径。 pathLen int 最大路径长度。 示例代码 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 /** * 查询外部通讯录头像 */ void demoNotifyProc::OnQueryContactAvatar(const char* account, const char* thirdUserId, const char* sipNumber, char* avatarPath, int pathLen) { Cdemo* app = (Cdemo*)AfxGetApp(); if (!app || (strlen(account) == 0 && strlen(thirdUserId) == 0 && strlen(sipNumber) == 0)) { //窗口已经关闭或数据为空 return; } string sAccount = account; string sThirdUserId = thirdUserId; string sSipNumber = sipNumber; /* 根据用户层自己的逻辑 + account thirdUserId sipNumber 获取到头像图片路径信息并复制到avatarPath char数组内*/ // 测试使用时，在D:\\picture\\路径下放置一张图片test.png strcpy_s(avatarPath, pathLen, "D:\\picture\\test.png"); }

注意事项 1 收到该通知的前提需要打开 7.5.3.1 表2 frame对象介绍 中的isUseExternalConfInfoWnd开关为true。 2 通知方法OnShowExternalConfInfoWnd中添加线程切换，抛到用户自己线程中，再显示用户自定义的 会议信息框(会议信息框显示需做置顶操作)。 3 显示用户自定义的会议信息框接口中，需要添加定时器检测(2s)： 鼠标若未移入自定义会议信息框区域，定时器时间到则销毁会议信息框。 鼠标若移入自定义会议信息框区域，则待鼠标移出信息框区域直接销毁会议信息框。 (若未添加3处理，无法覆盖所有的场景销毁会议信息框)

60.11.6更新内容 新增会议支持自动录制，新增允许自动录制会议isAutoRecord字段， 注意：会议开始后是否自动开启录制，默认关闭。开启自动录制会议时必须开启录制会议 创建会议HWMCreateConfParam参数说明 预约会议、编辑会议HWMOrderConfParam参数说明 新增自定义会议来电接听按钮显示 新增SDK库：HWRTCEngine.framework，具体使用请见新增HWRTCEngine库 父主题： 版本更新内容

changeVmrInfo 接口描述 该接口用于修改云会议室信息。 注意事项 尽量只修改来宾密码 方法定义 1 - (void)changeVmrInfo:(HWMModifyVMRParam *)info callback:(_Nonnull HWMSDKCompleteHandler)callback; 参数描述 表1 HWMModifyVMRParam参数说明 参数 是否必须 类型 描述 vmrId 是 NSString * 云会议室唯一ID guestPwd 是 NSString * 来宾密码 chairPwd 是 NSString * 主持人密码 vmrName 是 NSString * 云会议室名称 allowGuestStartConf 是 BOOL 允许来宾在主持人之前入会 confAllowJoinUser 否 HWMCallInRestrictionType 允许入会范围 isOpenWaitingRoom 否 BOOL 是否启用等候室 示例代码 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 /// 修改云会议信息 - (void)changeVmrInfo { HWMModifyVMRParam * vmrInfo = [[HWMModifyVMRParam alloc] init]; vmrInfo.guestPwd = getGuestPwd(); vmrInfo.chairPwd = getChairPwd(); vmrInfo.vmrName = getVmrName(); vmrInfo.vmrId = getVmrId(); [[HWMBizSdk getBizOpenApi] changeVmrInfo:vmrInfo callback:^(NSError * _Nullable error, id _Nullable result) { if (error) { NSLog(@"%@", error.localizedDescription); } else { NSLog(@"修改成功"); } }]; }

cancelConf 接口描述 该接口用于取消预约的会议。 注意事项 只有主持人可以取消会议 会中调用会结束会议 方法定义 1 - (void)cancelConf:(NSString *_Nonnull)confId callback:(_Nonnull HWMSDKCompleteHandler)callback; 参数描述 表1 参数说明 参数 是否必须 类型 描述 confId 是 NSString * 会议ID。 示例代码 1 2 3 4 5 6 7 8 9 10 /// 取消会议 - (void)cancelConf { [[HWMBizSdk getBizOpenApi] cancelConf:@"986927771" callback:^(NSError * _Nullable error, id _Nullable result) { if (error) { NSLog(@"%@",error.localizedDescription); } else { NSLog(@"取消会议成功"); } }]; }

editConf 接口描述 该接口用于编辑未开始的预约会议。 注意事项 会议未开始前且自己是主持人才可以调用接口。 预约会议中携带的与会者在编辑会议时需要传入userUuid（会议详情中每个与会者带有该参数）。 开启自动录制会议时必须开启录制会议。 所有字段必填，编辑修改的字段可来源于用户输入，其他不想修改的属性通过会议详情参数获取。 方法定义 1 - (void)editConf:(HWMOrderConfParam *_Nonnull)param callback:(_Nonnull HWMSDKCompleteHandler)callback; 参数描述 表1 HWMOrderConfParam参数说明，其余参数参见预约会议 参数 是否必须 类型 描述 confId 是 NSString * 会议ID。 isLiveOn 否 BOOL 是否开启直播。 示例代码 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 /// 编辑会议 - (void)editConf { HWMOrderConfParam * param = [[HWMOrderConfParam alloc] init]; param.confSubject = @"会议名称"; param.startTime = 1598759580; param.duration = 15; param.confType = HWMConfTypeVideo; param.isNeedConfPwd = YES; param.isRecordOn = NO; param.timeZone = 56; param.vmrId = @"";// vmr会议需要传入vmrId param.callInRestrictionType = HWMCallRestrictionAll; param.confId = @"986927771"; [[HWMBizSdk getBizOpenApi] editConf:param callback:^(NSError *_Nullable error, id _Nullable result) { if (error) { NSLog(@"编辑会议失败:%@", error.localizedDescription); } else { NSLog(@"编辑会议成功"); } }]; }

isOpenMicrophoneIncoming 接口描述 该接口用于自定义被邀入会时麦克风的开关状态。 注意事项 如果设置除主持人外的与会方入会后自动静音则该自定义无效果； 方法定义 1 - (BOOL)isOpenMicrophoneIncoming; 参数描述 无 示例代码 1 2 3 4 /// 被邀入会时是否打开麦克风 - (BOOL)isOpenMicrophoneIncoming { return NO; }

joinConf 接口描述 该接口用于通过会议ID和密码加入已经存在的会议。加入会议的方式有两种： 会议ID+会议密码入会：手动输入会议ID和会议密码密码。 会议ID+Random入会：通过邮件会议通知中的会议链接入会时（会议链接如：https://bmeeting.huaweicloud.com/#/j/981924330/e11ddec62ee760734fcf2ba55b79937eac2aa68677caf659），链接里面的是会议ID（即举例中的981924330）和会议的Random码（即举例中的e11ddec62ee760734fcf2ba55b79937eac2aa68677caf659）。 注意事项 ID入会参数使用子类HWMJoinConfParam，random入会参数使用子类HWMRandomConfParam 在登录和未登录状态下都可以调用该接口。 实际业务处理结果在对应的callback回调中。 方法定义 1 - (void)joinConf:(HWMBaseJoinConfParam * _Nonnull)param callback:(_Nonnull HWMSDKCompleteHandler)callback; 参数描述 表1 HWMBaseJoinConfParam 参数 是否必须 类型 描述 confId 是 NSString * 会议ID。 nickname 否 NSString * 会议昵称。在已登录状态下可为空，已登录时为空将使用登录的用户名作为会场名。 isCameraOn 是 BOOL 是否打开摄像头，默认关闭。 isMicOn 是 BOOL 是否打开麦克风，默认打开。 表2 HWMJoinConfParam参数说明，继承HWMBaseJoinConfParam 参数 是否必须 类型 描述 password 否 NSString * 会议密码。若希望以主持人身份入会，必须传入主持人密码。若希望以来宾身份入会，会议要求来宾密码时，必须传入来宾密码，会议不要求来宾密码时，可以为空。 isStopConflictConf 否 BOOL 强制结束和当前VMR会议资源冲突的会议（必须是vmr资源的拥有者才有权限，否则无效） 表3 HWMRandomConfParam参数说明，继承HWMBaseJoinConfParam 参数 是否必须 类型 描述 random 是 NSString * random入会时传入。 domain 否 NSString * 域名 。离线入会时使用。 示例代码 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 /// 加入会议 - (void)joinMeeting { HWMJoinConfParam *param = [[HWMJoinConfParam alloc] init]; param.confId = getConfId(); param.password = getPassword(); param.nickname = getNickName(); param.isCameraOn = NO; param.isMicOn = YES; [[HWMSdk getOpenApi] joinConf:param callback:^(NSError * _Nullable error, id _Nullable result) { if (error) { NSLog(@"入会失败%@", error.localizedDescription); }else{ NSLog(@"入会成功"); } }]; } /// random入会 - (void)joinMeetingByRandom { HWMRandomConfParam *param = [[HWMRandomConfParam alloc] init]; param.confId = getConfId(); param.random = getRandom(); param.nickname = getNickName(); param.isCameraOn = NO; param.isMicOn = YES; [[HWMSdk getOpenApi] joinConf:param callback:^(NSError * _Nullable error, id _Nullable result) { [self hideLoading]; if (error) { NSLog(@"入会失败%@", error.localizedDescription); }else{ NSLog(@"入会成功"); } }]; }

screenShareCoverView 接口描述 该接口用于屏幕共享/白板共享设置水印。该水印是在接收端叠加到共享内容上的。服务器上配置后才会显示水印。 1、在桌面共享、程序共享、白板共享的接收端叠加水印图片，只有服务器上会中水印打开的情况下自定义水印才生效。如果不自定义，默认按照手机号、邮箱、会议ID+昵称优先级顺序显示，字体透明度10%。 2、自定义水印时用户截屏时会有弹窗提示，如果不需要在初始化时配置关闭。 图1 设置水印效果，图片仅为示例 注意事项 注意不要添加全局手势。 自定义视图为全屏View,在共享视图上层，请设置合适透明度防止遮盖分享信息。 自定义弹窗提示是否需要关闭需在SDK初始化时配置参数enablePromptUserScreenshot 方法定义 1 - (UIView *)screenShareCoverView; 参数描述 无 返回值 无 示例代码 1 2 3 4 5 6 7 /// 屏幕共享/白板共享的设置水印。注意不要添加全局手势 - (UIView *)screenShareCoverView { UIImageView *coverImgView = [[UIImageView alloc] init]; coverImgView.image = [UIImage imageNamed:@"img"]; coverImgView.alpha = 0.2; return coverImgView; }

queryContactAvatarWithAccount:thirdUserId:number:completionBlock: 接口描述 该接口用于定制登录后的会中头像显示。 图1 生效后拦截头像显示效果 注意事项 未登录的头像不支持自定义。 方法定义 1 2 - (void)queryContactAvatarWithAccount:(NSString *)account thirdUserId:(NSString *)thirdUserId number:(NSString *)number completionBlock:(void(^)(NSError * _Nullable error, UIImage * _Nullable avatarImage))completionBlock; 参数描述 表1 参数 类型 描述 account NSString * 账号密码登录场景下优先使用此字段 thirdUserId NSString * appid登录场景下优先使用此字段 number NSString * 跨企业场景优先使用此字段 返回值 无 示例代码 1 2 3 4 5 6 7 /// 拦截头像显示 - (void)queryContactAvatarWithAccount:(NSString *)account thirdUserId:(NSString *)thirdUserId number:(nonnull NSString *)number completionBlock:(void(^)(NSError * _Nullable error, UIImage * _Nullable avatarImage))completionBlock { /// 根据account或者thirdUserId 设置图片，下面的仅为示例代码 UIImage *image = [UIImage imageNamed:@"custom_conf_setting"]; completionBlock(nil, image); }

getBrandName 接口描述 该接口用于设置会议二维码分享页面品牌名。 图3 自定义二维码分享品牌名 注意事项 跟shareConf:isAnonymous:inCtrl不能同时使用，同时使用getBrandName方法无效果。 方法定义 1 - (NSString *)getBrandName; 参数描述 参数 类型 描述 getBrandName NSString * 会议二维码分享页面品牌名。 返回值 无 示例代码 1 2 3 4 /// 设置会议二维码分享页面品牌名 - (NSString *)getBrandName { return @"集成品牌名"; }

shareConf:isAnonymous:inCtrl 接口描述 该接口用于分享会议拦截处理。实现代理后会拦截SDK默认的分享弹窗，如下图红框标注。 图1 分享拦截SDK弹窗 注意事项 如果实现该协议方法，则会中调用分享功能，会回调到该方法。 shareConf:isAnonymous:inCtrl方法实现后，SDK内部分享UI和会议二维码不显示，所以getShareLogoImages、getBrandName设置无效果。 方法定义 1 - (void)shareConf:(HWMConfDetail *)confInfo isAnonymous:(BOOL)isAnonymous inCtrl:(UIViewController *)controller; 参数描述 表1 参数说明 参数 类型 描述 confInfo HWMConfDetail * 会议信息 isAnonymous BOOL 是否匿名入会 controller UIViewController * 当前的vc，接入方可以在当前controller上弹出自己的定制分享页面 表2 HWMConfDetail 说明 参数 类型 描述 confId NSString * 会议id。 confSubject NSString * 会议主题。 accessNumber NSString * 会议接入码。 chairmanPwd NSString * 主持人密码。 generalPwd NSString * 来宾密码。 startTime NSString * 会议开始时间 endTime NSString * 会议结束时间 返回值 无 示例代码 1 2 3 4 5 6 7 8 /// 生效后会拦截SDK内部分享弹窗 - (void)shareConf:(HWMConfDetail *)confInfo isAnonymous:(BOOL)isAnonymous inCtrl:(UIViewController *)controller { NSLog(@"enter share conf"); ShareView *shareView = [[ShareView alloc] init]; [shareView showShareView:^(NSInteger index) { [UIUtil showMessage:[NSString stringWithFormat:@"点击了第%zd个按钮", index + 1]]; }]; }

清除界面配置 设置相关的代理后如果需要清除对应代理，可以置为nil，根据需求在对应位置设置。 1 2 3 4 5 6 [HWMSdk getSdkConfig].socialShareHandler = nil; // 可选，社交分享定制代理，用于定制会中分享能力 [HWMSdk getSdkConfig].audioConfToolBarHandler = nil; // 可选，音频会议会控菜单定制代理 [HWMSdk getSdkConfig].videoConfToolBarHandler = nil; // 可选，视频会议会控菜单定制代理 [HWMSdk getSdkConfig].participantListMenuHandler = nil; // 可选，与会者列表菜单定制代理 [HWMSdk getSdkConfig].confTitleBarMenuHandler = nil; // 可选，会议页面顶部titlebar菜单定制 [HWMSdk getSdkConfig].contactUIHandler = nil; // 可选，联系人UI 定制代理 父主题： 界面定制

uploadSelfAvatarWithFilePath:callback: 接口描述 该接口用于上传用户自己头像。 注意事项 文件路径为头像路径。 大小限制200k。 只支持jpg、png。 为了头像展示效果，建议图片宽高比为1:1。 回调error表示错误信息，nil表示成功。 方法定义 1 - (void)uploadSelfAvatarWithFilePath:(NSString *_Nullable)filePath callback:(_Nonnull HWMSDKCompleteHandler)callback; 参数描述 表1 参数 是否必须 类型 描述 filePath 否 NSString * 头像文件路径 返回值 无 示例代码 1 2 3 4 5 6 7 8 9 10 /// 上传用户个人头像 - (void)uploadSelfAvatar { [[HWMBizSdk getBizOpenApi] uploadSelfAvatarWithFilePath:self.headImgPath callback:^(NSError * _Nullable error, id _Nullable result) { if (error) { [UIUtil showMessage:[NSString stringWithFormat:@"上传失败%@", error.localizedDescription]]; } else { [UIUtil showMessage:@"上传成功"]; } }]; }

logout 接口描述 该接口用于退出已登录的会议账号。 注意事项 请在已登录的场景下调用。 回调error表示错误信息，nil表示成功。 方法定义 1 - (void)logout:(_Nonnull HWMSDKLogoutCompleteHandler)callback; 参数描述 无。 返回值 表1 退出返回HWMLogoutResult 参数 类型 描述 userUuid NSString * 账号uuid account NSString * 登录账号 thirdAccount NSString * appid登录的三方账号 示例代码 1 2 3 4 5 6 7 8 9 10 /// 退出登录 - (void)logout { [[HWMSdk getOpenApi] logout:^(NSError * _Nullable error, HWMLogoutResult * _Nullable result) { if (error == nil) { NSLog(@"登出成功"); } else { NSLog(@"登出失败"); } }]; }

login:password: 接口描述 该接口用于通过账号密码鉴权登录。 注意事项 创建会议，被邀入会等功能只有在登录后才能使用，若不登录，将无法体验完整会议功能。 回调error表示错误信息，nil表示成功。 方法定义 1 - (void)login:( NSString * _Nonnull )account password:( NSString * _Nonnull )password callback:(_Nonnull HWMSDKLoginCompleteHandler)callback;

loginBySSO: 接口描述 该接口用于通过SSO鉴权登录。 注意事项 创建会议，被邀入会等功能只有在登录后才能使用，若不登录，将无法体验完整会议功能。 回调error表示错误信息，nil表示成功。 方法定义 1 - (void)loginBySSO:(HWMSSOLoginParam)param callback:(_Nonnull HWMSDKLoginCompleteHandler)callback;

示例代码 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 /// AppId 登录接口 - (void)login { HWMAppIDLoginParam *appidInfo = [[HWMAppIDLoginParam alloc] init]; appidInfo.thirdUserId = getThirdUserId(); appidInfo.expireTime = 1599618620; appidInfo.nonce = getNonce(); appidInfo.userName = getUserName(); appidInfo.signature = getSignature(); [[HWMSdk getOpenApi] login:appidInfo callback:^(NSError * _Nullable error, HWMLoginResult * _Nullable result) { if (error == nil) { NSLog(@"登录成功"); }else{ NSLog(@"登录失败"); } }]; }

2. 异步初始化业务流程 注册监听 在Application中注册Activity生命周期的监听： registerActivityLifecycleCallbacks(new ActivityLifecycleHandle()); 接口调用 调用HWMSdk.initAsync(Application, OpenSDKConfig, SdkCallback) 异步初始化SDK。在初始化之前我们可以对SDK进行自定义的相关设置，设置步骤和示例代码请浏览5.3-8SDK初始化 回调处理 监听onSuccess回调，确保Android SDK初始化完成后再进行其他接口的调用。

服务的访问控制 身份认证 用户访问DSC的方式有多种，包括DSC控制台、API、SDK，无论访问方式封装成何种形式，其本质都是通过DSC提供的REST风格的API接口进行请求。 DSC的接口需要经过认证请求后才可以访问成功。DSC支持两种认证方式： Token认证：通过Token认证调用请求，访问DSC控制台默认使用Token认证机制。 AK/SK认证：通过AK（Access Key ID）/SK（Secret Access Key）加密调用请求。推荐使用AK/SK认证，其安全性比Token认证要高。 关于认证鉴权的详细介绍及获取方式，请参见认证鉴权。 访问控制 DSC支持通过权限控制（ IAM 权限）进行访问控制。 表1 DSC访问控制 访问控制方式 简要说明 详细介绍 权限控制 IAM权限 IAM权限是作用于云资源的，IAM权限定义了允许和拒绝的访问操作，以此实现云资源权限访问控制。管理员创建IAM用户后，需要将其加入用户组，并给用户组授予策略或角色，才能使得用户组中的用户获得对应的权限。 IAM产品介绍 DSC权限管理 DSC权限管理（细粒度） 父主题： 身份认证和访问控制