视频云转码api_音视频转码_实时音视频

华为云实时音视频服务(SparkRTC)凭借在视频业务领域长期技术积累,快速为行业提供高并发、低延迟、高清流畅、安全可靠的全场景、全互动、全实时的音视频服务,适用于在线教育、办公协作、社交文娱、在线金融等场景。

华为云实时音视频服务在调用媒体处理API前,您需要先获取用户Token,Token可以用于调用其他API时鉴权。


实时音视频 客户端SDK:提供Android、iOS、Windows、Web等平台的SDK,方便用户快速集成开发音视频通话、互动直播等功能。

实时音视频 服务端:接受连麦请求、指示连麦用户加入到实时音视频流的房间中,支持将主播端发布的流进行混流、录制等实时音视频处理。


全平台覆盖,极简接入

提供覆盖iOS、Android、Windows、macOS、Web、Electron等各平台,兼容适配各类终端。完善的示例代码Demo,2行代码轻松接入。

音视频API

华为云实时音视频服务(SparkRTC)凭借在视频业务领域长期技术积累,快速为行业提供高并发、低延迟、高清流畅、安全可靠的全场景、全互动、全实时的音视频服务,适用于在线教育、云会议、社交文娱等场景。

您可以使用本文档提供的API对华为云实时音视频服务进行相关操作,如应用管理、合流任务管理等。

在调用华为云实时音视频服务的API之前,请确保已经充分了解华为云实时音视频服务的相关概念,详细信息请参见产品介绍

调用说明

实时音视频提供了REST(Representational State Transfer)风格API,支持您通过HTTPS请求调用,调用方法请参见如何调用API

终端节点

终端节点即调用API的请求地址,SparkRTC部署时不区分物理区域,为全局服务。因此,SparkRTC的终端节点是rtc-api.myhuaweicloud.com

视频云转码api

媒体处理提供了REST(Representational State Transfer)风格API,支持您通过HTTPS请求调用。

同时媒体处理还提供多种编程语言的SDK供您使用,SDK的使用方法请参见MPC SDK

在调用媒体处理API前,请注意如下事项:

由于媒体处理服务无媒资存储功能,只能处理存储在OBS桶中的音视频文件,因此,您在调用视频转码、转封装、转动图、抽帧截图、独立加密接口前,需要将待处理的音视频文件上传到OBS桶中,并将OBS桶授权给媒体处理服务。具体操作指导请参见上传音视频文件

若您需要实时了解媒体处理在处理音视频文件的执行情况,您可以在调用API接口前,在媒体处理控制台配置消息通知功能。具体操作指导请参见配置消息通知功能

华为云实时音视频API约束与限制

华为云实时音视频服务设置了API流量控制,避免因短时间内重复调用API导致服务中断的情况出现。API流控限制说明如下所示。

接口分类

接口名称

接口流控

应用管理

•创建应用

•查询应用列表

•查询单个应用

•删除应用

•启用应用

•停用应用

60次/分钟

录制规则管理

•创建或更新录制规则

•查询录制规则列表

•查询录制规则

•更新录制规则

•删除录制规则

60次/分钟

自动录制配置

• 更新自动录制配置

• 查询自动录制配置

60次/分钟

应用回调管理

• RTC增值(录制)事件回调配置

• 查询增值(录制)事件回调配置

60次/分钟

合流任务管理

• 启动合流任务

• 查询合流任务

• 修改合流任务

• 停止合流任务

10次/秒

单流任务管理

• 启动单流任务

• 查询单流任务状态

• 停止单流任务

• 更新单流任务

10次/秒

房间管理

• 踢除在线用户

• 解散房间

60次/分钟

数据统计分析

• 查询房间列表

• 查询用户列表

• 查询实时规模

• 查询实时规模分布

• 查询实时质量数据

• 查询实时网络

• 查询用量

• 查询历史规模

• 查询历史质量

• 查询用户通话指标

• 查询用户异常体验事件

• 查询用户异常体验事件分布

30次/分钟

应用管理

接口名称

•创建应用

•查询应用列表

•查询单个应用

•删除应用

•启用应用

•停用应用

接口流控

60次/分钟

录制规则管理

接口名称

•创建或更新录制规则

•查询录制规则列表

•查询录制规则

•更新录制规则

•删除录制规则

接口流控

60次/分钟

自动录制配置

接口名称

• 更新自动录制配置

• 查询自动录制配置

接口流控

60次/分钟

应用回调管理

接口名称

• RTC增值(录制)事件回调配置

• 查询增值(录制)事件回调配置

接口流控

60次/分钟

合流任务管理

接口名称

• 启动合流任务

• 查询合流任务

• 修改合流任务

• 停止合流任务

接口流控

10次/秒

单流任务管理

接口名称

• 启动单流任务

• 查询单流任务状态

• 停止单流任务

• 更新单流任务

接口流控

10次/秒

房间管理

接口名称

• 踢除在线用户

• 解散房间

接口流控

60次/分钟

数据统计分析

接口名称

• 查询房间列表

• 查询用户列表

• 查询实时规模

• 查询实时规模分布

• 查询实时质量数据

• 查询实时网络

• 查询用量

• 查询历史规模

• 查询历史质量

• 查询用户通话指标

• 查询用户异常体验事件

• 查询用户异常体验事件分布

接口流控

30次/分钟

API使用常见问题

API使用常见问题

活动规则

活动对象:华为云电销客户及渠道伙伴客户可参与消费满送活动,其他客户参与前请咨询客户经理

活动时间: 2020年8月12日-2020年9月11日

  • 调用直播API的Token是什么?

    Token是系统颁发给用户的访问令牌,承载用户的身份、权限等信息。视频直播服务通过调用IAM获取Token接口,再调用其他接口时,使用获取的Token值进行鉴权,获得操作API的权限。Token的获取方法请参见如何调用API

  • 为什么调用API时返回“The token must be updated”?

    以下两种情况可能会导致调用API时返回The token must be update:

    • 您获取的token已过期,Token认证的Token有效期为24小时,当token过期时会返回该提示信息。

    • 您的账户出现欠费,充值后,未重新获取token,这种情况下也会导致返回提示信息。

    若出现该提示,您需要重新从IAM服务获取Token,具体请参见获取用户Token

  • 为什么调用API时提示“APIG.0301”?

    调用API时提示“APIG.0301”,可能有以下两个原因:

    • 提示"error_msg":"Incorrect IAM authentication information: decrypt token fail","error_code":"APIG.0301",是因为token解密失败,请检查token是否完整、是否过期、获取token与调用服务的区域是否跨区、账号是否因欠费等原因导致权限被限制。具体请参见Token认证鉴权。

    • 提示"error_msg":"Incorrect IAM authentication information: verify aksk signature fail","error_code":"APIG.0301",是因为AK/SK认证失败,请检查AK/SK是否正确、账号是否因欠费等原因导致权限被限制。具体请参见AK/SK认证鉴权。

  • 如何查询月并发录制峰值路数?

    您可以通过调用“查询录制用量”接口获取,具体请参见查询录制用量接口

  • 配置了录制回调通知,为什么只收到录制完成的回调,没收到录制开始的回调?

    可能是由于调用创建录制回调配置接口时,未设置“notify_event_subscription”参数,默认订阅RECORD_FILE_COMPLETE导致。若您需要订阅录制开始的回调,请调用修改录制回调配置接口,并在“notify_event_subscription”参数中增加“RECORD_NEW_FILE_START”字段即可。

  • 调用直播API的Token是什么?

    Token是系统颁发给用户的访问令牌,承载用户的身份、权限等信息。视频直播服务通过调用IAM获取Token接口,再调用其他接口时,使用获取的Token值进行鉴权,获得操作API的权限。Token的获取方法请参见如何调用API。