检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
什么是Signature？ 为保证RTC的通信安全，当用户加入频道时，华为云SparkRTC服务需要对其进行接入鉴权。 图1 鉴权原理 华为云SparkRTC系统使用数字签名作为接入鉴权方式，需要在相应的SDK的初始化或登录函数中提供“app_id”、“room_id”、“use
服务端如何计算Signature？ //认证用的app_key和app_id硬编码至代码中或以明文形式存储会有极大风险。建议密文形式配置存储在文件或者环境变量中，使用时解密，以确保安全。本例以app_key和app_id存放至环境变量为例，运行前请先在本地环境中设置完成环境变量APP_KEY和APP_ID。
Signature相关 什么是Signature？ 如何获取密钥？ 服务端如何计算Signature？
app_key为华为云SparkRTC针对每个app生成的鉴权密钥，需要安全保存，谨防泄漏。您可以通过以下方式获取： 登录实时音视频控制台。 在左侧导航栏中，选择“应用管理”，进入应用管理页面。 在目标应用行单击应用名称，进入应用详情页面。 “鉴权私钥”可见状态下，复制应用的鉴权私钥。 图1 应用详情界面
e”。“signature”为标识签名，由租户使用华为云SparkRTC提供的“app_key”，“app_id”以及当前的“room_id”，“user_id”，“ctime”，按照华为SparkRTC的签名生成样例自行生成。具体参数说明请参见表1。 //认证用的app_key
_NEED_CHANGE 90000053 音频设置路由和当前路由相同 音频设置路由和当前路由相同 HRTC_ERR_CODE_AUDIO_ROUTE_CHANGE_ERROR 90000054 音频路由切换失败 音频路由切换失败 HRTC_ERR_CODE_AUDIO_ROUTE_CLOSED
支持用户鉴权，华为云SparkRTC系统使用数字签名作为接入鉴权方式，需要在相应SDK的初始化或登录函数中提供“app_id”、“room_id”、“user_id”、“role”、“ctime”和“signature”等信息，才能接入华为SparkRTC服务。具体请参见接入鉴权。 父主题：
width int 旁路推流的输出视频流的总宽度，单位为px。360为默认值，取值范围为[64-1920] height int 旁路推流的输出视频流的总高度，单位为px。640为默认值，取值范围为[64-1920] videoBitrate int 旁路推流的输出视频的码率，单位为Kbp
double 总的内存利用率，单位(%) gatewayRtt int 到本地网关的延迟，单位ms sendBytes long 总的发送字节数，单位bytes sendVideoBytes long 视频的发送字节数，单位bytes sendAudioBytes long 音频的发送字节数，单位bytes
怎么理解SparkRTC的角色Role？ 角色Role是指用户在房间内的不同角色类型，不同角色类型有不同的权限模型。主要有如下三种角色类型： 主播（publisher）：只发流不收流主播型角色。SparkRTC预留的角色类型。 互动观众（joiner）：既能发流也能收流的互动型角色。 普
【返回参数】 0：成功。 >0：失败。具体请参见客户端错误码。 支持joiner，player角色间相互切换。 切换成功将触发onUserRoleChangedNotify回调。 切换失败将触发onError回调，返回错误码“HRTC_ERR_CODE_USER_ROLE_CHANGE_FAIL”。
加入房间前，可以通过joinRoom的userRole参数确认角色信息。 加入指定房间后才可以在指定房间内进行角色切换，当前仅支持joiner和player角色切换。跨房场景下，通过对应connection连接下的changeUserRole接口实现在跨入房间中的角色类型切换。 切换成功触发onUs
加入房间前，可以通过joinRoom的userRole参数确认角色信息。 加入指定房间后才可以在指定房间内进行角色切换，当前仅支持joiner和player角色切换。跨房场景下，通过对应connection连接下的changeUserRole接口实现在跨入房间中的角色类型切换。 切换成功触发onUs
开启/禁用音频最大三方模式的音轨 调用muteAudio4TopThree接口可以开启/禁用音频最大三方模式的音轨，true表示禁用音频最大三方模式的音轨，false表示开启音频最大三方模式的音轨。 示例代码如下： this.client.muteAudio4TopThree(true) 切换音频订阅模式/音频最大三方模式
附加请求头字段，如指定的URI和HTTP方法所要求的字段。例如定义消息体类型的请求头“Content-Type”，请求鉴权信息等。 详细的公共请求消息头字段请参见表3。 表3 公共请求消息头 名称 描述 是否必选 示例 Host 请求的服务器信息，从服务API的URL中获取。值为h
(int)renewAuthorization:(NSString *)signature ctime:(long long)ctime; 【功能说明】 鉴权签名过期，更新签名。 【请求参数】 signature：鉴权签名字符串。 ctime：过期时间。 【返回参数】 0：方法调用成功。
视频采集设备，拔插后需要应用层进行相应的处理，如：拔除摄像头的时候是否切换其他视频采集设备重新采集；插入摄像头的时候是否使用新插入设备进行重新采集。 recording-device-changed 【事件说明】 本地录音设备变更事件，当本地录音设备变更时触发。 【回调参数】 Devi
房间音视频暂停。 RTC_ERR_CODE_SIGNATURE_EXPIRED 90100030 signature expired 签名过期。 RTC_ERR_CODE_SIGNATURE_INVALID 90100031 signature invalid 签名非法。 RTC_ERR_CODE_RTC_ACS
【返回参数】 0：成功。 >0：失败。具体请参见客户端错误码。 支持joiner，player角色间相互切换。 切换成功将触发onUserRoleChangedNotify回调。 切换失败将触发onError回调，返回错误码“HRTC_ERR_CODE_USER_ROLE_CHANGE_FAIL”。
加入房间前，可以通过joinRoom的joinParam参数确认角色信息。 加入指定房间后才可以在指定房间内进行角色切换，当前仅支持joiner和player角色切换。跨房场景下，通过对应connection连接下的changeUserRole接口实现在跨入房间中的角色类型切换。 切换成功触发onUs
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
