检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
不同应用的唯一标识,在SparkRTC控制台中创建应用时自动生成。 房间 房间是一个音视频空间,同一房间内的用户可以互相接收对方的实时音视频数据。 SparkRTC使用房间这个虚拟的概念,用于用户之间的相互隔离。 只有在同一个房间里的用户才可以相互接收音视频。 房间ID的命名规则
用专门的签名SDK对请求进行签名。详细的签名方法和SDK使用方法请参见API签名指南。 签名SDK只提供签名功能,与服务提供的SDK不同,使用时请注意。 Token认证 Token的有效期为24小时,需要使用一个Token鉴权时,可以先缓存起来,避免频繁调用。 Token在计算机
调用此接口创建或更新录制规则。 若当前app在请求的location中无录制规则,则会创建新的录制规则 若当前app在请求的location中已有录制规则,则会更新原来的录制规则 接口约束 一个app在一个location最多创建一个录制规则。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。 URI GET /v2/apps 表1 Query参数 参数 是否必选 参数类型 描述 state 否 String 应用的状态: ACTIVATION:应用开启
停用应用 功能介绍 调用此接口停用单个应用。 应用停用后,新房间无法新增和加入,已加入的房间可以继续使用。合流、录制功能等也不可用。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
口获取(响应消息头中X-Subject-Token的值)。 Authorization 否 String 使用AK/SK方式认证时必选,携带的鉴权信息。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选,请求的发生时间。 X-Project-Id 否 String
查询单流任务状态 功能介绍 调用此接口查询单流任务状态。 租户的OBS桶内的情况,暂不支持查询。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。 URI GET /v2/ap
如何查看账单及扣费明细? 您可以在费用中心的“账单管理 > 费用账单”中查看具体账单及扣费明细。 父主题: 计费购买
断流后生成新文件:是指录制的直播流中断后,会立即生成新的录制文件。 其他数值:是指录制的直播流中断时间在设置范围内,则和之前录制的文件合并为一个文件,否则,生成新的录制文件。 单击“确定”,在录制规则列表中会增加一条新的录制规则。 图3 录制规则 您可以在录制规则列表中,根据实际需求选择
如何恢复已删除的录音文件? 由于录制文件是存储在OBS桶中的,若需要恢复已删除的录制文件,则需保证删除录制文件前OBS桶已开启多版本控制功能。 若桶开启了多版本控制功能,则删除的对象会保存到“已删除对象”列表中,您可以在“已删除对象”列表中恢复对象,具体请参见取消删除文件。 若桶
鉴权是如何生成的?在什么时候生成? 在加入房间时生成鉴权,并传入加入房间的参数中,鉴权的生成具体可参考接入鉴权。 父主题: SDK使用
登录实时音视频控制台。 在左侧导航栏中,选择“应用管理”,进入“应用管理”页面。 在需要创建录制回调的应用行,单击“配置”,进入录制配置页面。 在“回调配置”区域,单击“编辑”,配置回调信息,如图1所示。 图1 添加录制回调地址 回调地址:接收回调信息的服务器地址,仅支持HTTP和HTTPS协议。
采集主流的视频,主流即摄像头的流。默认值为false。 microphoneId:可选,string类型,在audio为true的时候有效,表示采集音频的源麦克风设备Id。如果不传,系统自动设置默认值。 cameraId:可选,string类型,在video为true的时候有效,
提供云端录制功能,支持单流/混流的模式将录制下来的文件存储到OBS或者点播服务中。 存储、录制审核、视频双录等。 文件混音 支持将本地或在线的音频和用户声音混音,发送给房间内其他用户。 在线教育、语聊房、在线合唱等。 旁路直播 将房间内的音视频流混流转码后推送RTMP的视频流给直播服务。 互动直播、大型会议等。
获取账号ID 在调用接口的时候,部分URL中需要填入账号ID,所以需要先在管理控制台上获取到账号ID。具体获取步骤如下: 登录管理控制台。 鼠标悬停在右上角的用户名,选择下拉列表中“我的凭证”。 在“API凭证”页面,即可获取对应的账号ID信息。 图1 获取账号ID 父主题: 附录
示例1:创建单流录制任务 场景描述 若您需要对某一个房间的实时音视频进行录制,可以在加入房间后,调用录制接口创建单流录制任务。 前提条件 已获取需要使用的SparkRTC服务的终端节点:rtc-api.myhuaweicloud.com。 已创建用于存储录制文件的OBS桶,并完成OBS桶授权。您可以通过调用OBS
自定义视频采集 功能描述 实时视频传输过程中,HWRtcEngine SDK通常会启动默认的视频模块进行采集和渲染。在以下场景中,您可能会发现默认的视频模块无法满足开发需求: app中已有自己的视频模块。 需要使用自定义的采集或播放处理。 某些视频采集设备被系统独占。 接口调用流程
音频自采集和音频自渲染 功能描述 实时音频传输过程中,HWRtcEngine SDK通常会启动默认的音频模块进行采集和渲染。在以下场景中,您可能会发现默认的音频模块无法满足开发需求: app中已有自己的音频模块。 需要使用自定义的采集或播放处理。 某些音频采集设备被系统独占。 注意事项
音频自采集和音频自渲染 功能介绍 实时音频传输过程中,HWRtcEngine SDK 通常会启动默认的音频模块进行采集和渲染。在以下场景中,您可能会发现默认的音频模块无法满足开发需求: app中已有自己的音频模块。 需要使用自定义的采集或播放处理。 某些音频采集设备被系统独占。 接口调用流程
功能介绍 调用此接口更新录制规则。 接口约束 如果规则修改后,修改后的规则对正在录制的流无效。 修改后对新的流有效,生效时间为5分钟,即修改规则5分钟后的录制任务会使用新规则进行录制。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动