云服务器内容精选

  • SetNetworkMode 接口描述 如华为云会议的媒体节点下沉部署到企业,并且管理节点也是通过企业内的代理访问,需要将网络模式设置成“企业内网接入”。 企业内的App无法直接访问公网(即媒体节点下沉和管理节点代理下沉场景)的情况下才需要调用该接口。 注意事项 该接口非必需调用,若不设置,则使用默认模式。 该接口为异步接口,返回值只代表接口是否调用成功,实际业务处理结果在对应的回调函数中返回。 方法定义 1 HWM_SDK_AGENT_API hwmsdk::HwmErrCode SetNetworkMode(const HwmNetWorkModeInfo* networkInfo); 回调函数 1 virtual void OnSetNetworkModeResult(hwmsdk::HwmErrCode ret, const char* reason) {}; 参数描述 表1 参数说明 参数 是否必须 类型 描述 networkInfo 是 HwmNetWorkModeInfo 网络模式信息。 表2 结构体HwmNetWorkModeInfo参数说明 参数 是否必须 类型 描述 accessType 是 HwmNetworkAccessType 网络接入类型。 netConnectType 是 HwmNetConnectType 网络连接类型。 表3 枚举HwmNetworkAccessType参数说明 枚举值 描述 ACCESS_TYPE_AUTO 默认值,目前和企业外网接入模式一致。 ACCESS_TYPE_INNER 企业内网接入,用于媒体和信令下沉场景,app从内网接入,信令/媒体消息走代理服务器才能访问云会议服务端。 ACCESS_TYPE_OUTER 企业外网接入,用于非媒体和信令下沉场景,互联网接入,信令/媒体消息可以直接访问云会议服务端。 表4 枚举HwmNetConnectType参数说明 枚举值 描述 NET_CONNECT_AUTO 默认值,自动模式。 NET_CONNECT_FORCE_VPN 强制vpn。 NET_CONNECT_FORCE_DIRECT 强制直连。 返回值 表5 返回值 类型 描述 HwmErrCode 成功返回0,其他值表示失败。失败返回值见错误码参考。 示例代码 1 2 3 4 5 6 7 8 9 10 11 12 13 /** * 设置网络模式 */ void demoSetNetworkModeDlg::SetNetworkMode() { hwmsdkagent::HwmNetWorkModeInfo networkMode{}; networkMode.accessType = hwmsdkagent::HwmNetworkAccessType::ACCESS_TYPE_AUTO; int ret = hwmsdkagent::SetNetworkMode(&networkMode); if (hwmsdk::HWM_COMMON_SUCCESS != ret) { AfxMessageBox(_T("Set network mode failed")); } }
  • 操作步骤 取出设备开机并使用数据线连接电脑。 图1 设备确认 在电脑上安装好投屏软件, 用于将设备投屏到电脑进行首次登录初始化。 在登陆界面地步点击“设置地址”,设置企业地址 进入登录界面,输入账号密码进行登录操作。 图2 智能设备登录界面 在ISDP配置的设备编号为登录智能设备端时的账号,密钥为登录智能设备端时的密码。 连接网络,录入设备帐号与设备密码登录跳转有两种情况,与电脑端设备配置有关 URL:https://isdp域名/admin/#/pub/equipment 图3 智能设备电脑端配置界面 当“是否主动接入视频”选择“是”,设备处于直播模式,登录成功后自动跳转到直播页面 图4 智能设备直播界面 当“主动接入视频”选择“否”,设备处于任务模式,登录成功后自动跳转至主页 图5 智能设备主页 图6 智能设备登录成功界面(有网络) 图7 智能设备无网络登录界面(登录时勾选离线模式)
  • setLanguage 接口描述 该接口设置SDK国际化语言。默认是中文。 注意事项 实现自定义语言,要求在主工程的资源文件(路径:/src/main/res/)中创建对应的国际化文件,如新增阿拉伯语则可以创建/values-ar/string.xml。新增的国际化语言,内容请参考languagetemplates文件夹中的语言模板。通过该接口设置的语言应与系统当前语言保持一致。 图1 国际化语言模板 方法定义 void setLanguage(LanguageType languageType, String language);
  • 前提条件 如果需要配置AD域,请先参考配置云桌面和Windows AD网络互通(多个子项目对接同一个AD服务器时,需要先参考配置云桌面和Windows AD网络互通使待对接的所有子项目网络与Windows AD网络互通),在AD服务器上开启相关端口,并准备以下数据: 域名 域管理员账号 域管理员密码 主域控制器名称 主域控制器IP地址 主DNS服务器IP地址 备域控制器名称(可选) 备域控制器IP地址(可选) 备DNS服务器IP地址(可选)
  • Init 接口描述 用于启动并且初始化SDK。 注意事项 调用该接口之前请先修改HwmSdk文件夹下HwmSdk.exe文件的名称。 该接口用于启动并初始化SDK,在调用其他接口之前必须先调用该接口并等待初始化回调结果。 每次调用初始化接口会重新启动SDK,之前所有设置与操作将不复存在。 该接口为异步接口,返回值只代表接口是否调用成功,实际业务处理结果在对应的回调函数中返回。 方法定义 1 HWM_SDK_AGENT_API hwmsdk::HwmErrCode Init(HwmInitInfo *initInfo);
  • 参数描述 表1 结构体HwmCorpConfigInfo参数说明 参数 类型 描述 enablePstn bool 是否支持手机呼叫。 enableSms bool 是否支持短信通知。 enableRecord bool 是否支持会议录制。 allowGuestStartConf bool 是否允许来宾提前启动会议。 allowGuestStartConfTime unsigned int 允许来宾提前入会时间范围(单位:分钟) :0-随时,n-提前n分钟启动会议。 enableShowAddressBookStructure bool 是否支持通讯录显示。
  • SetUserSavePath 接口描述 该接口用于设置用户文件(包括本地录制文件)的保存路径。 注意事项 该接口非必需调用,若不设置,则使用默认路径。 该接口为异步接口,返回值只代表接口是否调用成功,实际业务处理结果在对应的回调函数中返回。 方法定义 1 HWM_SDK_AGENT_API hwmsdk::HwmErrCode SetUserSavePath(HWMSavePathType type, const char* path);
  • 参数描述 表1 枚举HwmUserCorpInfoNotifyType说明 参数 描述 HWM_USER_CORP_INFO_NOTIFY_TYPE_USER_DELETE 用户已注销。 HWM_USER_CORP_INFO_NOTIFY_TYPE_USER_JOIN_NEW_CORP 用户已加入新的企业(接受邀请、创建企业变成新企业的用户)。 HWM_USER_CORP_INFO_NOTIFY_TYPE_USER_LEAVE_CURRENT_CORP 用户已被移出当前企业(企业管理员删除、解散、用户主动离开企业变成注册用户)。 HWM_USER_CORP_INFO_NOTIFY_TYPE_USER_RESET 用户重置(Smartrooms账号被重置激活码或者账号被删除)。 HWM_USER_CORP_INFO_NOTIFY_TYPE_USER_VMR_CHANGE 用户vmr变化。 HWM_USER_CORP_INFO_NOTIFY_TYPE_USER_NAME_CHANGE 用户姓名变更。 HWM_USER_CORP_INFO_NOTIFY_TYPE_USER_STATUS_CHANGE 接入账号状态变化。
  • 开启共享声音功能 配置开启共享时包含电脑声音功能,调用enableSDKCapability接口 示例代码 /// 开启共享声音 [[HWMBizSdk getBizOpenApi] enableSDKCapability:HWMSDKCapabilitySuportShareAudio]; 配置开启共享时包含电脑声音功能后,用户发起共享时,在开始共享窗口会显示【共享时包含电脑声音】选项。若未配置开启该功能,则窗口上不显示该选项。如下图: 取消 App Sandbox 功能 SDK 自动安装音频驱动插件需要关闭 App Sandbox 功能,并获取 root 权限。 在 App 的 entitlements 描述文件中,删除 App Sandbox 条目。如下图: 取消 App Sandbox 功能后,首次点击勾选【共享时包含电脑声音】选项时,会获取 root 权限。在用户单击【好】后,开始自动安装音频驱动插件。如下图: 若未取消 App Sandbox 功能,首次点击勾选【共享时包含电脑声音】选项时,会弹框提示到官网下载。在用户单击【下载】后,会跳转到官网。如下图: 下载链接可通过initWithConfig接口中的appUrl字段配置,该接口用于启动并初始化SDK,参考8.5.1.1 初始化部分。若未配置appUrl,则不显示下载。 App Sandbox 功能取消后,App 内获取到的用户路径会发生变化,App 会无法上架到 Mac App Store。
  • enableSDKCapability 接口描述 用于开启特性支持。 方法定义 1 - (void)enableSDKCapability:(HWMSDKCapabilitySuport)type; 参数描述 表1 HWMSDKCapabilitySuport说明 参数 类型 描述 HWMSDKCapabilitySuportVideoHD NSUInteger 开启720P高清视频,默认360P。 HWMSDKCapabilitySuportShareAudio NSUInteger 开启显示共享时包含电脑声音选项,默认不开启。 HWMSDKCapabilitySuportHideNoCameraView NSUInteger 开启显示隐藏非视频与会者选项,默认开启。 HWMSDKCapabilitySuportBreakoutConf NSUInteger 开启分组会议,默认开启。 HWMSDKCapabilitySuportConfirmRecord NSUInteger 录制安全提示,默认不开启。
  • 开启隐藏非视频与会者功能 示例代码 /// 开启显示隐藏非视频与会者选项 [[HWMBizSdk getBizOpenApi] enableSDKCapability:HWMSDKCapabilitySuportHideNoCameraView]; 开启后,在会议设置中可以看到隐藏非视频与会者选项: 示例代码 /// 关闭隐藏非视频与会者选项 [[HWMBizSdk getBizOpenApi] disableSDKCapability:HWMSDKCapabilitySuportHideNoCameraView]; 关闭后,会议设置不显示隐藏非视频与会者选项。
  • 设置会控保底ip地址 接口描述 该接口用于设置会控保底ip地址。 注意事项 该接口非必需调用,若不设置,则使用默认保底ip。 多个地址中间用分号隔开,最多支持4个地址。 方法定义 SDKERR setGuaranteedIpAddresses(String addresses); 示例代码 SDKERR sdkerr = HWMBizSdk.getBizOpenApi().setGuaranteedIpAddresses(ip); DemoUtil.showToast("设置结果: " + sdkerr.getValue() + " " + sdkerr.getDescription()); 父主题: 基础配置
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 最小长度:1 最大长度:5000 X-Language 否 String 语言环境,值为通用的语言描述字符串,比如zh-cn等,默认为zh-cn。 会根据语言环境对应展示一些国际化的信息,比如工单类型名称等。 最小长度:1 最大长度:32 X-Time-Zone 否 String 环境时区,值为通用的时区描述字符串,比如GMT+8等,默认为GMT+8。 涉及时间的数据会根据环境时区处理。 最小长度:1 最大长度:32
  • 响应参数 状态码: 200 表3 响应Body参数 参数 参数类型 描述 total_count Integer 总数 最小值:0 最大值:65535 incident_template_list Array of IncidentTempV2 objects 模板列表 数组长度:0 - 65535 表4 IncidentTempV2 参数 参数类型 描述 incident_template_id String 模板id 最小长度:1 最大长度:64 incident_template_name String 模板名称 最小长度:1 最大长度:64 incident_template_content String 模板内容 最小长度:1 最大长度:128
  • 响应示例 状态码: 200 成功返回200 { "total_count" : 1, "incident_template_list" : [ { "incident_template_id" : "123", "incident_template_name" : "转账创建模板", "incident_template_content" : "|- 账户id: 转账描述: " } ] }