检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
+ (instancetype)sharedEngine; 【功能说明】 创建连麦引擎实例。 【请求参数】 无 【返回参数】 返回引擎实例对象。 destroy - (void)destroy; 【功能说明】 注销引擎。 【请求参数】 无 【返回参数】 无 initWithConfig
HWRtcConnection：成功返回连接对象指针，失败返回为空。 同一时间最多只能创建4个连接对象，每个连接对象对应的房间ID必须互不相同。 如果使用HWRtcConnection对象加入房间，则加入房间的房间ID不能和已创建连接对象对应的房间ID相同。 同一时间只能以JOINER角色加入某一个房间。
【功能说明】 根据房间ID，创建HRTCConnection对象，为跨房做准备。 通过此接口创建一个与房间关联的HRTCConnection连接对象。 该方法支持多次调用，创建多个HRTCConnection连接对象，调用每个对象中的joinRoom方法，可以同时加入到多个房间。在每个
【功能说明】 设置共享对象。 【请求参数】 param：共享对象的具体信息。具体请参见HWRtcScreenShareParam。 【返回参数】 0：方法调用成功。 > 0：方法调用失败。具体请参见HWRtcErrorCode。 只支持macOS。 如果共享对象为桌面类型，则对象名称sour
用户主动离开 HWRtcLeaveReasonServerError 服务器异常 HWRtcLeaveReasonBreakdown sfu服务故障 HWRtcLeaveReasonServiceUnreachable 服务不可达 HWRtcLeaveReasonInternalError
dler）。 【返回参数】 IHRTCConnection：成功返回连接对象指针，失败返回内容为空。 同一时间最多只能创建4个连接对象，每个连接对象对应的房间ID必须互不相同。加上IHRTCEngine对象，即同时最多可加入5个房间，且在这5个房间中最多只能同时有一个joiner
加入房间后可以调用getScreenShareSources获取屏幕共享对象列表，然后遍历找到其中HRTCScreenShareSourceInfo.type为HRTC_SCREEN_SHARE的对象，该对象就是屏幕对象，再调用setScreenShareTarget设置共享桌面参数。桌面共享不支持区域共享。
加入房间后可以调用getScreenShareSources获取屏幕共享对象列表，然后遍历找到其中HRTCScreenShareSourceInfo.type为HWRtcScreenShareTypeDesktop的对象，该对象就是屏幕对象，再调用setScreenShareTarget设置共享桌面参数。桌面共享不支持区域共享。
任务创建成功，返回job的概要信息，如包含job_id 400 创建单流任务失败，语义有误，当前请求无法被服务器理解，或参数有误 404 创建单流任务失败，应用不存在 500 创建单流任务失败，服务器错误 错误码 请参见错误码。 父主题： 单流任务管理
conn, int error, const char* msg) 【功能说明】 发生错误，触发此回调。返回客户端错误码或者服务端错误码。 【回调参数】 conn：连接对象。 error：错误码，具体请参见HRTCErrorCode。 msg：错误描述。 onConnectionChangedNotify
版本规划 本章节为您介绍实时音视频服务（SparkRTC）客户端SDK的版本支持机制。 版本号说明 版本号格式为a.b.c.d，其中： a为大版本号：在版本架构重构的情况下更新。 b为小版本号：在重大特性或接口变更的情况下更新。 c为月度开发版本号：月度累加。 d为release
离开原因枚举，取值如表2 离开房间原因所示。 msg：string类型，原因描述。 } 表2 离开房间原因 枚举值 描述 0 用户主动离开 1 服务器异常 2 sfu服务故障 3 服务不可达503 4 内部错误 5 被踢出房间 6 签名过期 7 重连超时 8 网络检测，UI不需要关注该错误码，不对外体现
用户昵称，该昵称为UTF-8编码。 signature：必选，string[512]类型，鉴权签名字串，应用开发者需要向远端服务器获取鉴权签名。 远端服务器需要您自行部署，具体请参见接入鉴权。 ctime：必选，string类型，签名UTC时间戳，单位秒。 role：必选，num
SparkRTC是否支持本地服务端录制？ SparkRTC支持本地服务端录制，但未完全开放，如需使用请提交工单联系华为技术工程师。 本地服务端录制需要使用Linux SDK，可部署在客户Linux 服务器上，使用客户自有的服务器和存储资源。 云端录制无需部署客户自有Linux服务器，减轻了研发和运维的压力，更轻量便捷。
HRTC_LEAVE_REASON_SERVER_ERROR 服务器异常。 HRTC_LEAVE_REASON_BREAKDOWN sfu服务故障。 HRTC_LEAVE_REASON_SERVICE_UNREACHABLE 服务不可达。 HRTC_LEAVE_REASON_INTERNAL_ERROR
服务端错误码 当SDK运行出现网络、媒体相关等错误时，SDK无法自动恢复，需要APP干预或进行用户提示。该错误码由服务端产生，通过onError返回。 表1 服务端错误码 错误码 描述 错误原因 RTC.10000001 内部错误 程序或环境问题 RTC.31000000 节点不存在
服务端错误码 当SDK运行出现网络、媒体相关等错误时，SDK无法自动恢复，需要APP干预或进行用户提示。该错误码由服务端产生，通过onError返回。 表1 服务端错误码 错误码 描述 错误原因 RTC.10000001 内部错误 程序或环境问题 RTC.31000000 节点不存在
服务端错误码 当SDK运行出现网络、媒体相关等错误时，SDK无法自动恢复，需要APP干预或进行用户提示。该错误码由服务端产生，通过onError返回。 表1 服务端错误码 错误码 描述 错误原因 RTC.10000001 内部错误 程序或环境问题 RTC.31000000 节点不存在
服务端错误码 当SDK运行出现网络、媒体相关等错误时，SDK无法自动恢复，需要APP干预或进行用户提示。该错误码由服务端产生，通过onError返回。 表1 服务端错误码 错误码 描述 错误原因 RTC.10000001 内部错误 程序或环境问题 RTC.31000000 节点不存在
服务端如何计算Signature？ //认证用的app_key和app_id硬编码至代码中或以明文形式存储会有极大风险。建议密文形式配置存储在文件或者环境变量中，使用时解密，以确保安全。本例以app_key和app_id存放至环境变量为例，运行前请先在本地环境中设置完成环境变量APP_KEY和APP_ID。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
