检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
什么是Signature? 为保证RTC的通信安全,当用户加入频道时,华为云SparkRTC服务需要对其进行接入鉴权。 图1 鉴权原理 华为云SparkRTC系统使用数字签名作为接入鉴权方式,需要在相应的SDK的初始化或登录函数中提供“app_id”、“room_id”、“user_i
release 释放IHRTCConnection对象资源 getRoomId 获取当前连接房间号 setNetworkBandwidth 设置网络带宽限制 房间功能 表2 房间功能接口 接口 描述 joinRoom 加入房间 leaveRoom 离开房间 renewAuthorization
HTTP方法 方法 说明 GET 请求服务器返回指定资源。 PUT 请求服务器更新指定资源。 POST 请求服务器新增资源或执行特殊操作。 DELETE 请求服务器删除指定资源,如删除对象等。 HEAD 请求服务器资源头部。 PATCH 请求服务器更新资源的部分内容。 当资源不存在的
cryptionSec String 加密密钥,仅sdk加密模式下需要设置。必须是长度大于等于32的16进制字符串。 suiteType HRTCSuiteType 加密算法,当前仅支持HRTC_ENCRYPTION_128_CTR,sdk加密模式下需要设置 secFormat HRTCCryptionSecFormat
release 释放Connection setEncryption 设置端到端加密模式 setNetworkBandwidth 设置网络带宽限制 表2 房间功能接口 接口 描述 joinRoom 加入房间 leaveRoom 离开房间 getRoomId 获取房间id renewAuthorization
boolean isRecving) 【功能说明】 上报下行辅流状态变化通知,接收端探测网络变化,分配给下行辅流,如果有辅流因为带宽不足被停掉或者带宽恢复而恢复,则上报给产品。 【回调参数】 conn: 连接对象。 userId:下行辅流对应的用户ID。 isRecving:是否接受。
} 签名生成样例 为防止“app_key”密钥泄漏,建议您配置自己的应用签名分发服务器,向服务器传入“app_id”、“room_id”,“user_id”和“ctime”后,由服务器返回签名。详细代码示例如下所示: 1 2 3 4 5 6 7 8 9 10
HRTCSuiteType,加密算法,仅模式HRTC_CRYPTO_AUTHENTICATION_SDK需要 cryptionSec char *,加密密钥,仅模式HRTC_CRYPTO_AUTHENTICATION_SDK需要设置。必须是字符长度大于等于32位的16进制字符串。 secFormat HR
setEncryption 设置端到端加密模式 setAccessResourceType 设置接入环境 setNetworkBandwidth 设置网络带宽限制 房间功能 表2 房间功能接口 接口 描述 joinRoom 加入房间 leaveRoom 离开房间 changeUserRole 设置用户角色
ode。 totalBitRate:总带宽。 【返回参数】 0:方法调用成功。 > 0:方法调用失败。具体请参见HWRtcErrorCode。 华为SDK系统有默认的编码设置(720P+360P),一般可以不设置发流编码参数。如果您确实需要自定义发流编码参数,请参考华为SDK系统
HRTC_ERR_CODE_MEDIA_CMP_ERR 90000015 媒体协商失败 与服务器之间媒体协商失败。 HRTC_ERR_CODE_SERVER_NO_RESPONSE 90000016 服务器没有响应 选看在2-4s内没有收到服务器的响应。 HRTC_ERR_CODE_USER_ROLE_CHANGE_FAIL
domain:可选,string[128]类型,服务器的域名。需要与注册到SparkRTC平台的合法企业域名保持一致,该参数在SDK 1.0+版本中必填,SDK 2.0+版本中非必填。 countryCode: 可选,string[2]类型,需要满足ISO 3166-1的2位字母的国家码
状态码: 500 配置失败,服务器端错误 { "error_code" : "RTC.00002xxx", "error_msg" : "InternalError" } 状态码 状态码 描述 200 配置成功 400 配置失败,语义有误,当前请求无法被服务器理解,或参数有误 404
√ √ √ √ setAccessResourceType 设置接入环境 √ √ √ √ setNetworkBandwidth 设置网络带宽限制 √ √ √ √ renewAppid 设置Appid √ √ √ √ 房间功能 表2 房间功能接口 接口 描述 windows是否支持
状态码: 500 查询失败,服务器端错误 { "error_code" : "RTC.00002xxx", "error_msg" : "InternalError" } 状态码 状态码 描述 200 app详细信息 400 语义有误,当前请求无法被服务器理解,或参数有误 404
云端录制与回放 概述 单流录制 合流录制
Not Acceptable 服务器无法根据客户端请求的内容特性完成请求。 407 Proxy Authentication Required 请求要求代理的身份认证,与401类似,但请求者应当使用代理进行授权。 408 Request Timeout 服务器等候请求时发生超时。 客户
setEncrytionParam 设置端到端加密模式 setAccessResourceType 设置接入的环境 setNetworkBandwidth 设置网络带宽限制 房间功能 表2 房间功能接口 接口 描述 joinRoom 加入房间 changeUserRole 设置用户的角色,切换角色时使用 renewAuthorization
omServerError 90000020 加入房间服务器错误 加入房间服务器错误。 HWRtcErrorCodejoinRoomServiceUnreachable 90000021 加入房间服务器无法访问 加入房间服务器无法访问。 HWRtcErrorCodejoinRoomAuthFail
19:对端用户无帧率 20:本端服务器下行无码流 21:本端服务器下行无帧率 abnormal_factor_desc String 异常因素描述,支持国际化 当异常类型为1时,异常因素描述与异常因素对应,取值范围为: 建链失败 房间非空闲 服务器异常 服务器反馈503 鉴权失败 鉴权重试