检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
认证鉴权 调用接口有如下两种认证方式,您可以选择其中一种进行认证鉴权。 AK/SK认证:通过AK(Access Key ID)/SK(Secret Access Key)加密调用请求。推荐使用AK/SK认证,其安全性比Token认证要高。 Token认证:通过Token认证调用请求。
入门指引 首次使用SparkRTC,您需要完成如下操作: 注册华为账号:单击进入注册页面。 完成实名认证:单击进入实名认证。 账户充值:为确保正常使用SparkRTC,您需要进行账户充值(超过1元)。 提交工单联系华为云技术客服,进行业务咨询。 图1 入门流程 SparkRTC的入门操作流程说明如表1所示。
如果用户已注册账户,可直接登录管理控制台,从主页选择“视频 > 实时音视频”。 如果未注册,请单击此处注册华为账号并开通华为云,完成实名认证。 API方式 如果用户需要将华为云实时音视频服务集成到第三方系统,用于二次开发,请使用API方式访问华为云实时音视频服务,具体操作请参见《服务端API参考》。
users Array of RtcUser objects 用户列表 表6 RtcUser 参数 参数类型 描述 domain String 域名 app String 应用标识 room_id String 房间ID uid String 用户id session String 会话id
String 项目ID,获取方法请参考获取项目ID。 表2 Query参数 参数 是否必选 参数类型 描述 domain 否 String 域名 app_id 是 String 应用id room_id 是 String 房间ID user_id 否 String 发送端用户 peer_id
描述 URI-scheme 表示用于传输请求的协议,当前所有API均采用HTTPS协议。 Endpoint 指定承载REST服务端点的服务器域名或IP,不同服务不同区域的Endpoint不同,您可以从地区和终端节点获取。 例如IAM服务在“华北-北京四”区域的Endpoint为“iam
DOMESTIC:国内范围。 OVERSEA:海外范围。 GLOBAL:全球范围。 tenant_name String 账号名 domain String 域名,App对应域名 create_time String 创建时间,形如“2006-01-02T15:04:05.075Z”,时区为:UTC authentication
ID相同的应用程序才能进入同一个房间进行互动。应用的appId请参考应用管理进行获取。 domain:可选,string[128]类型,服务器的域名。需要与注册到SparkRTC平台的合法企业域名保持一致,该参数在SDK 1.0+版本中必填,SDK 2.0+版本中非必填。 countryCode: 可选,string[2]类型,需要满足ISO
应用管理 您可以在实时音视频控制台创建应用并查询应用的基本信息,应用创建后,您可以使用应用对应的App ID和域名进入互动频道。 注意事项 首次使用华为云实时音视频服务,请先提交工单联系华为云技术客服进行业务咨询。 创建应用 登录实时音视频控制台。 在左侧导航栏中,选择“应用管理”,进入“应用管理”页面。
网络质量非常差 HRTCConstant 表50 HRTCConstant常量说明 常量 值 int HRTC_MAX_DOMAIN_LEN 119,域名长度。 int HRTC_MAX_APPID_LEN 128,app_id长度。 int HRTC_MAX_LOG_PATH_LEN 226,日志路径。
DOMESTIC:国内范围。 OVERSEA:海外范围。 GLOBAL:全球范围。 tenant_name String 账号名 domain String 域名,App对应域名 create_time String 创建时间,形如“2006-01-02T15:04:05.075Z”,时区为:UTC authentication
RtcServerRoomInfo objects 房间列表信息 表6 RtcServerRoomInfo 参数 参数类型 描述 domain String 域名 app String 应用标识 room_id String 房间ID state String 房间状态,取值如下: RUNNING:开启中
状态码 调用实时音视频API时,可能返回的状态码如表1所示。 表1 状态码 返回值 说明 200 OK 请求正常。 201 Created 创建类的请求完全成功。 202 Accepted 已经接受请求,但未处理完成。 204 No Content 请求完全成功,同时HTTP响应不包含响应体。
SDK使用 创建引擎并初始化。 域名不需要设置,由SDK自动获取。appId获取方法请参见创建应用。 1 2 3 4 5 6 7 8 9 10 11 12 _rtcEngine = [HWRtcEngine sharedEngine]; HWRtcEngineConfig
单击房间ID或操作列的详情,进入通话详情页面。 在通话详情页面,您可以根据实际需求查看以下信息: 通话基本信息:可查看房间ID、应用ID、域名、房间状态、整段通话的起止时间。单击“查看事件”还可查看用户在该房间中的所有操作事件,具体事件类型及ID请参见表1。 房间画像信息:可查看
countryCode } let client = HRTC.createClient(config) domain:string[128]类型,服务器域名。该参数在SDK 1.0+版本中必填,SDK 2.0+版本中非必填。 appId:string[128]类型,必填。应用ID,只有App
终端节点即调用API的请求地址,SparkRTC部署时不区分物理区域,为全局服务。因此,SparkRTC的终端节点如表1所示。 表1 SparkRTC的终端节点 区域名称 区域 终端节点(Endpoint) 所有 ALL rtc-api.myhuaweicloud.com 约束与限制 华为云实时音视频服务
数据分析。 表1 控制台功能介绍 分类 功能 功能介绍 应用管理 应用管理 支持用户创建并管理应用,应用创建后可以使用对应的App ID和域名进入互动频道。 录制配置 支持为实时音视频互动配置录制规则,SparkRTC将按照录制规则ID进行录制,并将录制文件存储到OBS桶中。 视镜
如果客户端用TypeScript开发,TypeScript的版本不低于3.8.3。 由于浏览器安全策略限制,仅支持通过https://域名的方式访问,或者直接在本地搭建服务器,通过localhost:端口访问,否则无法获取摄像头及麦克风的权限。 SDK集成 将获取的SDK压缩包放置在自己项目的“sdk”目录下。