实时音视频 SPARKRTC-华为云

实时音视频 SPARKRTC-认证鉴权:Token认证

Token认证 Token的有效期为24小时，需要使用一个Token鉴权时，可以先缓存起来，避免频繁调用。 Token在计算机系统中代表令牌（临时）的意思，拥有Token就代表拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Token可通过调用获取用户Token获取用户Token接口获取。调用本服务API需要项目级别的Token，即调用获取用户Token获取用户Token接口时，请求body中auth.scope的取值需要选择project，如下所示。 { "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "username", //IAM用户名 "password": $ADMIN_PASS, //IAM用户密码，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全 "domain": { "name": "domainname" //IAM用户所属账号账号名 } } } }, "scope": { "project": { "name": "xxxxxxxx" //项目名称 } } } } 获取Token后，再调用其他接口时，您需要在请求消息头中添加“X-Auth-Token”，其值即为Token。例如Token值为“ABCDEFJ....”，则调用接口时将“X-Auth-Token: ABCDEFJ....”加到请求消息头即可，如下所示。 1 2 3 4 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/projects POST https://{{endpoint}}/v3/auth/projects Content-Type: application/json X-Auth-Token: ABCDEFJ.... 您还可以通过这个视频教程了解如何使用Token认证：https://bbs.huaweicloud.com/videos/101333。

实时音视频 SPARKRTC

实时音视频 SPARKRTC-认证鉴权:AK/SK认证

AK/SK认证 AK/SK签名认证方式仅支持消息体大小在12MB以内，12MB以上的请求请使用Token认证。 AK/SK认证就是使用AK/SK对请求进行签名，在请求时将签名信息添加到消息头，从而通过身份认证。 AK（Access Key ID）：访问密钥ID。与私有访问密钥关联的唯一标识符；访问密钥ID和私有访问密钥一起使用，对请求进行加密签名。 SK（Secret Access Key）：私有访问密钥。与访问密钥ID结合使用，对请求进行加密签名，可标识发送方，并防止请求被修改。使用AK/SK认证时，您可以基于签名算法使用AK/SK对请求进行签名，也可以使用专门的签名SDK对请求进行签名。详细的签名方法和SDK使用方法请参见API签名指南。签名SDK只提供签名功能，与服务提供的SDK不同，使用时请注意。

实时音视频 SPARKRTC

实时音视频 SPARKRTC-构造请求:请求消息体（可选）

请求消息体（可选）该部分可选。请求消息体通常以结构化格式（如JSON或XML）发出，与请求消息头中Content-Type对应，传递除请求消息头之外的内容。若请求消息体中的参数支持中文，则中文字符必须为UTF-8编码。每个接口的请求消息体内容不同，也并不是每个接口都需要有请求消息体（或者说消息体为空），GET、DELETE操作类型的接口就不需要消息体，消息体具体内容需要根据具体接口而定。对于获取用户Token获取用户Token接口，您可以从接口的请求部分看到所需的请求参数及参数说明。将消息体加入后的请求如下所示，加粗的斜体字段需要根据实际值填写，其中username为用户名，domainname为用户所属的账号账号名称，$ADMIN_PASS表示用户登录密码，xxxxxxxxxxxxxxxxxx为project的名称，如“cn-north-1”，您可以从管理员处地区和终端节点获取。 scope参数定义了Token的作用域，下面示例中获取的Token仅能访问project下的资源。您还可以设置Token的作用域为某个账号下所有资源或账号的某个project下的资源，详细定义请参见获取用户Token获取用户Token。 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens POST https://{{endpoint}}/v3/auth/tokens Content-Type: application/json { "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "username", "password": "$ADMIN_PASS", //建议在配置文件或者环境变量中密文存放，使用时解密，确保安全 "domain": { "name": "domainname" } } } }, "scope": { "project": { "name": "xxxxxxxxxxxxxxxxxx" } } } } 到这里为止这个请求需要的内容就具备齐全了，您可以使用curl、Postman或直接编写代码等方式发送请求调用API。对于获取用户Token接口，返回的响应消息头中的“X-Subject-Token”就是需要获取的用户Token。有了Token之后，您就可以使用Token认证调用其他API。

实时音视频 SPARKRTC 如何调用API

实时音视频 SPARKRTC-构造请求:请求消息头

请求消息头附加请求头字段，如指定的URI和HTTP方法所要求的字段。例如定义消息体类型的请求头“Content-Type”，请求鉴权信息等。详细的公共请求消息头字段请参见表3。表3 公共请求消息头名称描述是否必选示例 Host 请求的服务器信息，从服务API的URL中获取。值为hostname[:port]。端口缺省时使用默认的端口，https的默认端口为443。否使用AK/SK认证时该字段必选。 code.test.com or code.test.com:443 Content-Type 消息体的类型（格式）。推荐用户使用默认值application/json，有其他取值时会在具体接口中专门说明。是 application/json Content-Length 请求body长度，单位为Byte。否 3495 X-Project-Id project id，项目编号。请参考获取项目ID章节获取项目编号。否如果是专属云场景采用AK/SK认证方式的接口请求，或者多project场景采用AK/SK认证的接口请求，则该字段必选。 e9993fc787d94b6c886cbaa340f9c0f4 X-Auth-Token 用户Token。用户Token也就是调用获取用户Token获取用户Token接口的响应值，该接口是唯一不需要认证的接口。请求响应成功后在响应消息头（Headers）中包含的“X-Subject-Token”的值即为Token值。否使用Token认证时该字段必选。注：以下仅为Token示例片段。 MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ API同时支持使用AK/SK认证，AK/SK认证使用SDK对请求进行签名，签名过程会自动往请求中添加Authorization（签名认证信息）和X-Sdk-Date（请求发送的时间）请求头。 AK/SK认证的详细说明请参见认证鉴权的“AK/SK认证”。对于获取用户Token获取用户Token接口，由于不需要认证，所以只添加“Content-Type”即可，添加消息头后的请求如下所示。 1 2 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens Content-Type: application/json 1 2 POST https://{{endpoint}}/v3/auth/tokens Content-Type: application/json

实时音视频 SPARKRTC 如何调用API

实时音视频 SPARKRTC-构造请求:请求URI

请求URI 请求URI由如下部分组成： {URI-scheme}://{Endpoint}/{resource-path}?{query-string} 尽管请求URI包含在请求消息头中，但大多数语言或框架都要求您从请求消息中单独传递它，所以在此单独强调。表1 URI中的参数说明参数描述 URI-scheme 表示用于传输请求的协议，当前所有API均采用HTTPS协议。 Endpoint 指定承载REST服务端点的服务器域名或IP，不同服务不同区域的Endpoint不同，您可以从管理员处地区和终端节点获取。例如IAM服务在“华北-北京四”区域的Endpoint为“iam.cn-north-4.myhuaweicloud.com”。 resource-path 资源路径，即API访问路径。从具体API的URI模块获取，例如“获取用户Token”API的resource-path为“/v3/auth/tokens”。 query-string 查询参数，是可选部分，并不是每个API都有查询参数。查询参数前面需要带一个“?”，形式为“参数名=参数取值”，例如“?limit=10”，表示查询不超过10条数据。例如您需要获取IAM在“华北-北京四”区域的Token，则需使用“华北-北京四”区域的Endpoint（iam.cn-north-4.myhuaweicloud.com），并在获取用户Token的URI部分找到resource-path（/v3/auth/tokens），拼接起来如下所示。 1 https://iam.cn-north-4.myhuaweicloud.com/v3/auth/tokens 图1 URI示意图为方便查看，在每个具体API的URI部分，只给出resource-path部分，并将请求方法写在一起。这是因为URI-scheme都是HTTPS，而Endpoint在同一个区域也相同，所以简洁起见将这两部分省略。

实时音视频 SPARKRTC 如何调用API

实时音视频 SPARKRTC-构造请求:请求方法

请求方法 HTTP请求方法（也称为操作或动词），它告诉服务您正在请求什么类型的操作。表2 HTTP方法方法说明 GET 请求服务器返回指定资源。 PUT 请求服务器更新指定资源。 POST 请求服务器新增资源或执行特殊操作。 DELETE 请求服务器删除指定资源，如删除对象等。 HEAD 请求服务器资源头部。 PATCH 请求服务器更新资源的部分内容。当资源不存在的时候，PATCH可能会去创建一个新的资源。在获取用户Token获取用户Token的URI部分，您可以看到其请求方法为“POST”，则其请求为： 1 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens 1 POST https://{{endpoint}}/v3/auth/tokens

实时音视频 SPARKRTC 如何调用API

实时音视频 SPARKRTC-错误码

错误码当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。状态码错误码错误信息描述处理措施 400 SCASE.00001006 Invalid parameter value. 参数值无效。请参考返回的error message，或者联系技术支持 400 SCASE.00001007 Invalid parameter value, CreateRequest.BuildId is not exists. 参数值无效，CreateRequest.BuildId不存在。请使用正确的应用包创建应用进程队列 400 SCASE.00001008 Invalid parameter value, CreateRequest.BuildId can not be used. 参数值无效，不能使用CreateRequest.BuildId。请使用就绪的应用包创建应用进程队列 400 SCASE.00001009 Invalid parameter value, CreateRequest.Region is invalid. 参数值无效，CreateRequest.Region无效。请在支持的区域中创建应用进程队列 400 SCASE.00001010 Invalid parameter value, CreateRequest.Bandwidth is invalid. 参数值无效，CreateRequest.Bandwidth无效。请使用正确的带宽大小创建应用进程队列 400 SCASE.00001011 Invalid parameter value, total concurrent executions exceed limit. 参数值无效，并发执行总数超过了限制。请使用正确的concurrent executions参数创建应用进程队列 400 SCASE.00001012 Fleet do not support update when state is not active. 会话状态不是“ACTIVE”，不支持更新应用。请等待应用进程队列就绪后再执行更新操作 400 SCASE.00001013 Fleet id could not be found. 未找到应用进程队列ID。请使用正确的应用进程队列ID 400 SCASE.00001014 Fleet do not support delete when state is not active. 会话状态不是“ACTIVE”，不支持删除应用。请等待应用进程队列就绪或者错误时再执行删除操作 400 SCASE.00001022 Invalid parameter value, FleetId is needed. 参数值无效，需要FleetId。请设置fleetid参数 400 SCASE.00001023 Server session id can not be found. 未设置sever session id。请设置sever session id参数 400 SCASE.00001024 Invalid parameter value, ServerSessionId is needed. 参数值无效，需要设置server session id。请设置server session id参数 400 SCASE.00010200 Create server session failed: xxx. 创建服务端会话失败：xxx。根据报错信息做重试 400 SCASE.00010201 Read server session xxx : xxx. 查询服务端会话xxx失败：xxx。根据报错信息做重试，或者联系管理员 400 SCASE.00010203 List server sessions failed: xxx. 查询服务端会话列表失败：xxx。检查查询参数 400 SCASE.00010204 Update server session xxx failed: xxx 更新服务端会话失败：xxx。根据报错信息做重试，或者联系管理员 400 SCASE.00010300 Create client session failed: xxx. 创建客户端会话失败：xxx。根据报错信息做重试，或者联系管理员 400 SCASE.00010301 Create client sessions failed: xxx. 批量创建客户端会话失败：xxx。根据报错信息做重试，或者联系管理员 400 SCASE.00010302 Query client session: xxx. 查询客户端会话xxx失败：xxx。检查查询参数 403 SCASE.00001002 X-Auth-Token is not found in request head. 在请求头中未找到X-Auth-Token。在请求头中增加X-Auth-Token 403 SCASE.00001003 X-Auth-Token Permission Failed. X-Auth-Token鉴权失败。请参考返回的error message，检查是否余额不足，账号被冻结等 403 SCASE.00001004 X-Auth-Token is expired. X-Auth-Token已过期。请参考返回的error message，检查是否余额不足，账号被冻结等 403 SCASE.00001005 Project_id in X-Auth-Token mismatches with project_id in url. X-Auth-Token中的project_id与url中的project_id不匹配。请参考返回的error message，检查是否余额不足，账号被冻结等 404 SCASE.00001013 Fleet id can not be found. 未找到fleet id。请设置fleet id参数 404 SCASE.00010202 Server session xxx not found 服务端会话xxx不存在。检查服务会话ID是否存在 404 SCASE.00010303 Client session xx not found. 客户端会话xxx不存在。检查服务会话ID是否存在 500 SCASE.00001001 Internal Server Error. 内部服务器错误。请联系技术支持父主题：附录

实时音视频 SPARKRTC 附录

实时音视频 SPARKRTC-入门指引

入门指引首次使用SparkRTC，您需要完成如下操作：注册华为账号：单击进入注册页面。完成实名认证：单击进入实名认证。账户充值：为确保正常使用SparkRTC，您需要进行账户充值（超过1元）。提交工单联系华为云技术客服，进行业务咨询。图1 入门流程 SparkRTC的入门操作流程说明如表1所示。表1 入门流程说明序号操作方法操作说明 1 获取App ID和域名在SparkRTC控制台中创建应用后获取App ID和域名。 2 获取SparkRTC SDK SDK开发包请提交工单联系华为云技术客服获取。 3 集成SparkRTC SDK 集成Android SDK 集成iOS SDK 集成MAC SDK 集成Windows SDK 集成Web SDK SparkRTC提供了Android、iOS、MAC、Windows和Web版本的SDK，您可以根据实际需求进行SDK的集成和开发。 4 实现SparkRTC基本功能 Android SDK功能开发 iOS SDK功能开发 MAC SDK功能开发 Windows SDK功能开发 Web SDK功能开发集成SDK后，您需要实现SparkRTC的基本功能，如加入房间、发布和订阅流、离开房间等。 5 验证SparkRTC功能 SparkRTC基本功能开发完成后，您可以进行编译验证，其中roomId和userId可以自行定义。

实时音视频 SPARKRTC

实时音视频 SPARKRTC-什么是Signature？

什么是Signature？为保证RTC的通信安全，当用户加入频道时，华为云SparkRTC服务需要对其进行接入鉴权。图1 鉴权原理华为云SparkRTC系统使用数字签名作为接入鉴权方式，需要在相应的SDK的初始化或登录函数中提供“app_id”、“room_id”、“user_id”、“ctime”和“signature”等信息，才能接入华为SparkRTC服务。signature为标识签名，由租户使用华为云SparkRTC提供的“app_key”，按照华为SparkRTC的签名算法自行生成。应用开发者需要向远端服务器获取鉴权签名。具体请参见接入鉴权。父主题： Signature相关

实时音视频 SPARKRTC Signature相关

实时音视频 SPARKRTC-合流录制:实现步骤

实现步骤请参见OBS帮助中心创建桶。若已有OBS桶，请直接执行步骤2。创建的OBS桶所在区域必须为华北-北京四。 OBS桶授权。登录实时音视频控制台。在左侧导航树中选择“云资源授权”，进入桶授权页面。在对应的OBS桶行单击“授权”，完成桶授权。配置录制规则。登录实时音视频控制台。在左侧导航树中选择“应用管理”，进入应用管理页面。在需要创建录制规则的应用行单击“录制配置”，进入录制配置页面。在“录制规则”页签，单击“添加”，进入添加录制规则页面。一个应用ID仅支持创建一个录制规则。请您按照实际需求配置录制参数，参数说明如表1所示。表1 录制参数说明参数名描述存储-桶存储录制文件的OBS桶。目前录制文件仅支持存储到华北-北京四的OBS桶中。区域 OBS桶所在的区域。存储-路径存储录制文件的OBS桶路径。录制格式录制文件的格式，支持HLS和MP4文件格式。 HLS规则 m3u8命名规则录制m3u8文件的存储路径和文件的前缀。默认命名格式： {app_id}/{record_format}/{stream}_{file_start_time}/{stream}_{file_start_time} 上述特殊变量的含义如下： app_id：应用ID。 record_format：录制格式。 stream：流名。 file_start_time：文件生成时间。录制周期录制时长支持0-720分钟，最小录制周期为1分钟，最大录制周期为12小时，超过12小时，系统将按照命名规则生成新文件。如果录制周期为0，则整个流录制为一个文件。最大断流合并时长支持如下三种配置：断流后生成新文件：是指录制的直播流中断后，会立即生成新的录制文件。断流后不生成新文件：是指录制的直播流中断后，会和之前录制的文件合并为一个文件。最大断流合并时长为30天。其他数值：是指录制的直播流中断时间在设置范围内，则和之前录制的文件合并为一个文件，否则，生成新的录制文件。 MP4规则 mp4命名规则录制mp4文件的存储路径和文件的前缀。默认命名格式： {app_id}/{record_format}/{stream}_{file_start_time}/{stream}_{file_start_time} 上述特殊变量的含义如下： app_id：应用ID。 record_format：录制格式。 stream：流名。 file_start_time：文件生成时间。录制周期录制时长支持1-180分钟，最小录制周期为1分钟，最大录制周期为3小时，超过3小时，系统将按照命名规则生成新文件。最大断流合并时长支持如下两种配置：断流后生成新文件：是指录制的直播流中断后，会立即生成新的录制文件。其他数值：是指录制的直播流中断时间在设置范围内，则和之前录制的文件合并为一个文件，否则，生成新的录制文件。单击“确定”，在录制规则列表中会增加一条新的录制规则。图2 录制规则您可以在录制规则列表中，根据实际需求选择是否开启自动录制功能。自动录制功能开启后，若该应用下有新创建的房间，则会按照已配置的录制规则自动对该房间中的实时音视频互动过程进行录制。自动录制功能开启后，仅对同一应用下新创建的房间生效，自动录制功能开启前已创建的房间不生效。加入房间。录制规则配置完成后，您可以通过SparkRTC APP加入某个SparkRTC房间进行音视频互动，SparkRTC服务会根据配置的录制规则对正在直播的音视频进行录制。若配置录制规则时，未开启自动录制功能，则加入SparkRTC房间后，您需要调用实时音视频API开启云端录制任务，SparkRTC才会根据API中的录制规则ID对实时音视频互动画面进行录制。回放录制文件。录制完成后，您可以在OBS控制台中或通过回调消息查看录制文件。通过OBS控制台查看录制文件在OBS管理控制台左侧导航栏选择“对象存储”。在桶列表中单击存储SparkRTC录制文件的桶，进入“概览”页面。在左侧导航栏，单击“对象”，查看录制文件信息。您还可以对录制文件进行下载、分享等操作，具体请参见OBS帮助中心。

实时音视频 SPARKRTC

实时音视频 SPARKRTC-合流录制:实现流程

实现流程创建OBS桶：创建用于存储SparkRTC录制文件的OBS桶，若已有OBS桶，请直接执行2。由于单AZ桶的可靠性低于多AZ桶，为避免因OBS服务异常导致录制失败，建议您创建多AZ桶用于录制文件的存储。 OBS桶授权：在SparkRTC服务中对存储录制文件的OBS桶进行授权，允许SparkRTC服务将录制文件存储在对应的OBS桶中。配置录制规则：为实时音视频互动配置录制规则，并开启自动录制功能，加入SparkRTC房间后，与应用中的录制规则ID相同的录制模板会自动生效，录制内容按录制设置存储至OBS中。还可以通过设置回调地址获取录制任务状态通知。加入房间：录制规则配置完成后，您可以通过SparkRTC APP加入某个SparkRTC房间进行音视频互动，SparkRTC会根据配置的录制规则对正在直播的音视频进行录制。若配置录制规则时，未开启自动录制功能，则加入SparkRTC房间后，您需要调用实时音视频API开启、查询和控制云端录制任务。SparkRTC服务才会根据接口中的录制规则ID对实时音视频互动画面进行录制。回放录制文件：录制完成后，在已配置的回调地址中会收到录制任务的回调消息，您可以获取到录制文件的基本信息，也可以在OBS中管理录制文件，如下载、分享、删除等。录制文件的分辨率与推流分辨率相关，按推流原分辨率进行录制。

实时音视频 SPARKRTC

实时音视频 SPARKRTC-合流录制:合流布局

合流布局在合流录制模式下，支持分屏九宫格模板和共享屏幕模板（主视窗居左/主视窗居右）两种预设合流布局。同时，也支持用户自定义合流布局样式（自定义视频窗格位置）。九宫格模板每个用户画面平铺在画布上，大小一致。根据用户数量，动态调整每个画面的大小和位置。最多支持25个画面。不同人数的实际布局效果如下图所示。如果实际视频流的宽高比与视窗的宽高比不一致，视频画面会裁剪以适配视窗的大小。中途有流退出房间，则该条流的画面会被后进入房间的流顶替。如果房间内的人数不足，则剩余位置显示背景色。如果用户只发送音频，仍然会占用画面位置。支持背景图，如果房间内人数不足，显示背景图。屏幕共享模板屏幕分享（或者主讲人摄像头画面）始终占据屏幕左侧或者右侧大画面位置，其他用户依次垂直排列于旁边。最多支持17个画面。不同人数的实际布局效果如下图所示。大视窗画面，可选择主讲摄像头流或共享屏幕流。大视窗画面，显示指定的UID用户的视频，如果未指定或者指定用户未进入频道，大视窗区域显示背景色。左侧大视窗为了保持内容的完整性采用缩放方式处理，右侧小视窗采用裁剪方式适配视窗的大小。右侧小视窗画面按照加入房间的时间先后顺序排列。右侧小视窗有流退出房间，则该条流的画面会被后进入房间的流顶替。如果房间内的人数不足，则剩余位置显示背景色。如果用户只发送音频，仍然会占用画面位置。支持背景图，如果房间内人数不足，显示背景图。自定义布局模板支持用户自定义合流布局样式，可灵活设置用户画面的大小，指定用户画面在视频画布上的相对位置。可自定义各个视频窗格在画布上的位置。可自定义各个视频窗格的宽和高。针对每一个窗格，可通过user_id指定显示房间内某一用户。针对窗格，可自定义选择呈现摄像头流或者屏幕分享流。如果实际视频流的宽高比与视窗的宽高比不一致，自定义布局场景下支持选择裁剪和缩放两种模式。如果房间内的人数不足，则剩余位置显示背景色。如果用户只发送音频，仍然会占用画面位置。支持背景图，如果房间内人数不足，则显示背景图。

实时音视频 SPARKRTC

实时音视频 SPARKRTC-单流录制:实现步骤

实现步骤请参见OBS帮助中心创建桶。若已有OBS桶，请直接执行步骤2。创建的OBS桶所在区域必须为华北-北京四。 OBS桶授权。登录实时音视频控制台。在左侧导航树中选择“云资源授权”，进入桶授权页面。在对应的OBS桶行单击“授权”，完成桶授权。配置录制规则。登录实时音视频控制台。在左侧导航树中选择“应用管理”，进入应用管理页面。在需要创建录制规则的应用行单击“录制配置”，进入录制配置页面。在“录制规则”页签，单击“添加”，进入添加录制规则页面。一个应用ID仅支持创建一个录制规则。请您按照实际需求配置录制参数，参数说明如表1所示。表1 录制参数说明参数名描述存储-桶存储录制文件的OBS桶。目前录制文件仅支持存储到华北-北京四的OBS桶中。区域 OBS桶所在的区域。存储-路径存储录制文件的OBS桶路径。录制格式录制文件的格式，支持HLS和MP4文件格式。 HLS规则 m3u8命名规则录制m3u8文件的存储路径和文件的前缀。默认命名格式： {app_id}/{record_format}/{stream}_{file_start_time}/{stream}_{file_start_time} 上述特殊变量的含义如下： app_id：应用ID。 record_format：录制格式。 stream：流名。 file_start_time：文件生成时间。录制周期录制时长支持0-720分钟，最小录制周期为1分钟，最大录制周期为12小时，超过12小时，系统将按照命名规则生成新文件。如果录制周期为0，则整个流录制为一个文件。最大断流合并时长支持如下三种配置：断流后生成新文件：是指录制的直播流中断后，会立即生成新的录制文件。断流后不生成新文件：是指录制的直播流中断后，会和之前录制的文件合并为一个文件。最大断流合并时长为30天。其他数值：是指录制的直播流中断时间在设置范围内，则和之前录制的文件合并为一个文件，否则，生成新的录制文件。 MP4规则 mp4命名规则录制mp4文件的存储路径和文件的前缀。默认命名格式： {app_id}/{record_format}/{stream}_{file_start_time}/{stream}_{file_start_time} 上述特殊变量的含义如下： app_id：应用ID。 record_format：录制格式。 stream：流名。 file_start_time：文件生成时间。录制周期录制时长支持1-180分钟，最小录制周期为1分钟，最大录制周期为3小时，超过3小时，系统将按照命名规则生成新文件。最大断流合并时长支持如下两种配置：断流后生成新文件：是指录制的直播流中断后，会立即生成新的录制文件。其他数值：是指录制的直播流中断时间在设置范围内，则和之前录制的文件合并为一个文件，否则，生成新的录制文件。单击“确定”，在录制规则列表中会增加一条新的录制规则。图3 录制规则您可以在录制规则列表中，根据实际需求选择是否开启自动录制功能。自动录制功能开启后，若该应用下有新创建的房间，则会按照已配置的录制规则自动对该房间中的实时音视频互动过程进行录制。自动录制功能开启后，仅对同一应用下新创建的房间生效，自动录制功能开启前已创建的房间不生效。加入房间。录制规则配置完成后，您可以通过SparkRTC APP加入某个SparkRTC房间进行音视频互动，SparkRTC服务会根据配置的录制规则对正在直播的音视频进行录制。若配置录制规则时，未开启自动录制功能，则加入SparkRTC房间后，您需要调用实时音视频API开启云端录制任务，SparkRTC才会根据API中的录制规则ID对实时音视频互动画面进行录制。回放录制文件。录制完成后，您可以在OBS控制台中或通过回调消息查看录制文件。通过OBS控制台查看录制文件在OBS管理控制台左侧导航栏选择“对象存储”。在桶列表中单击存储SparkRTC录制文件的桶，进入“概览”页面。在左侧导航栏，单击“对象”，查看录制文件信息。您还可以对录制文件进行下载、分享等操作，具体请参见OBS帮助中心。

实时音视频 SPARKRTC 云端录制与回放

实时音视频 SPARKRTC-单流录制:实现流程

实现流程创建OBS桶：创建用于存储SparkRTC录制文件的OBS桶，若已有OBS桶，请直接执行2。由于单AZ桶的可靠性低于多AZ桶，为避免因OBS服务异常导致录制失败，建议您创建多AZ桶用于录制文件的存储。 OBS桶授权：在SparkRTC服务中对存储录制文件的OBS桶进行授权，允许SparkRTC服务将录制文件存储在对应的OBS桶中。配置录制规则：为实时音视频互动配置录制规则，并开启自动录制功能，加入SparkRTC房间后，与应用中的录制规则ID相同的录制模板会自动生效，录制内容按录制设置存储至OBS中。还可以通过设置回调地址获取录制任务状态通知。加入房间：录制规则配置完成后，您可以通过SparkRTC APP加入某个SparkRTC房间进行音视频互动，SparkRTC会根据配置的录制规则对正在直播的音视频进行录制。若配置录制规则时，未开启自动录制功能，则加入SparkRTC房间后，您需要调用实时音视频API开启、查询和控制云端录制任务。SparkRTC服务才会根据接口中的录制规则ID对实时音视频互动画面进行录制。回放录制文件：录制完成后，在已配置的回调地址中会收到录制任务的回调消息，您可以获取到录制文件的基本信息，也可以在OBS中管理录制文件，如下载、分享、删除等。录制文件的分辨率与推流分辨率相关，按推流原分辨率进行录制。

实时音视频 SPARKRTC 云端录制与回放

实时音视频 SPARKRTC-用量统计:操作步骤

操作步骤登录实时音视频控制台。在左侧导航树中选择“用量统计”，进入用量统计页面。您也可以通过在“应用管理”页面的“操作”列，单击“用量”跳转到“用量统计”页面进行查看。选择需要查看的时间和应用名称，即可查看到相关统计数据及明细。统计图中展示了不同分辨率档位（标清/高清/超清）的视频通话时长和纯语音通话时长统计数据。在统计图中您可以进行如下操作：单击如下图标可以选看或取消选看不同规格的音视频通话时长统计情况。图1 规格图标将鼠标指针停留在统计数值线上，可以查看各规格的音视频通话时长。将鼠标指针停留在统计图上，滚动鼠标滚轮可针对某时间跨度范围内的统计图时间横轴进行拉大或缩小整体占比。图2 音视频时长统计 “用量统计”中记录的通话时长仅供数据分析和参考使用，计费数据请以账单为准。

实时音视频 SPARKRTC

云服务器内容精选

实时音视频 SPARKRTC

7*24

备案

专业服务

退订

建议反馈

售前咨询热线