本文介绍鉴权的与或逻辑。 功能介绍 客户配置多种鉴权规则后，可在直播控制台自助配置多种鉴权之间的与或逻辑。其中： 与关系：配置开启多种鉴权时，如果选择【与关系】，则需要所有的鉴权功能都通过才算通过。 或关系：配置开启多种鉴权时，如果选择【或关系】，只需要其中一种鉴权功能通过就算通过。 如果客户未配置与或关系，系统默认按照【与关系】处理。 前提条件 已自助配置开启Referer防盗链、IP黑/白名单、URL鉴权、UA鉴权中的一种或多种。 操作步骤 1. 登录直播控制台。 2. 在【域名列表】页面，单击目标域名操作列中的【编辑】。 3. 单击【访问控制】。 4. 假设已开启Referer防盗链和URL鉴权。单击【鉴权逻辑】页面，选择【鉴权逻辑】。 5. 配置完成后，单击页面右下方【提交保存】。

参数 说明 是否允许空referer访问 可以设置是否允许空Referer字段访问资源，即是否允许通过浏览器地址栏直接访问资源URL。 类型 支持黑名单和白名单模式。 ● 白名单：允许名单内的域名或IP请求访问资源，拒绝其它域名和IP请求访问。 ● 黑名单：允许非名单内的域名和IP请求访问资源，拒绝名单中的域名或IP请求访问。 黑白名单规则 黑名单或白名单中的域名/IP。最多添加400个，使用换行符分隔，支持通配、支持IP、支持端口。 鉴权范围 配置需要进行鉴权的协议。如果未配置，则默认对所有请求进行校验。

本文简述工单列表页面支持的功能。 功能介绍 您可以在【工单列表】页面查看域名当前进行操作的进展或者历史相关操作记录。 操作步骤 1. 登录直播控制台。 2. 单击左侧导航栏中的【域名管理】下方的【工单列表】。 3. 您可以过滤域名、事件类型或者状态，查询对应工单。

编号 字段示例 字段含义 1 36.111.140.140 用户IP 2 ctyun.cn 加速域名 3 video/xflv 文件类型 4 [20240402135946] 日志生成时间 5 GET 请求方式 6 请求URL 7 HTTP/1.1 HTTP协议 8 200 HTTP响应状态码 9 16776379 CDN节点响应大小，单位byte 10 请求头Referer的值 11 curl/7.86.0 请求头UserAgent的值

响应JSON参数 代码 类型 字段名称 code int 状态码 message string 描述信息 TemplateID string 模板ID 示例 请求路径： 请求JSON示例 { "TemplateID": "65shhklue975easaa457", "Params":{ "RecordNotifyUrl": "ctyun.cn", "SnapshotNotifyUrl":"ctyun.cn1", "IdentifyNotifyUrl": "ctyun.cn", "CallbackReqAuth": "on", "CallbackAuthKey": "test" } } 正常返回JSON示例 { "code": 100000, "message": "success", "TemplateID": "65shhklue975easaa457" }

接口功能介绍 调用本接口删除证书。 使用说明 单个用户一分钟限制调用10000次，并发不超过100； 删除证书前必须确保该证书未绑定域名。 接口详情 请求方式：post 请求路径：/cert/deletecert 请求参数 参数 类型 名称 是否必填 说明 ::::: name string 证书备注名 是 响应参数 参数 类型 说明 ::: code int 状态码 message string 描述信息 示例 请求路径： 请求示例1 { "name": "xxxx" } 正常响应示例 { "code": 100000, "message": "success" } 请求示例2 { "name": "xxxx" } 异常响应示例 { "code": 100005, "message": "不存在此证书" } 错误码请参考: 参数code和message含义

接口功能介绍 支持从第三方拉流并转推到其他直播平台。 使用说明 使用第三方转推接口时，需要提供拉流和转推的完整URL。 接口详情 请求方式：POST 请求路径：/live/extredirect/createextredirect 请求参数 参数名 类型 名称 是否必填 说明 ::::: DomainName string 域名 否 App string 频道名 否 Stream string 流名 否 SrcUrl String array 任务拉流地址 是 可配置多个拉流地址任务会依次尝试，例如：["rtmp://live.pull.ctyun.cn/live/test1","rtmp://live.pull.ctyun.cn/live/test2"] DstUrl string 任务推流地址 是 ExtParam object 扩展参数配置 否 见下方 ExtParam.PullRetryType string 拉流重试方式 否 有两种类型，分别是： “0”，不重试，默认值 “1”，按时长重试，时长通过PullRetryTimeOut设置 只能传“0”和“1”。 ExtParam.PullRetryTimeOut string 拉流转推重试时长 否 PullRetryType 为“1”时生效，表示所有源流都不存在拉流转推重试时长，默认10分钟，单位s 响应参数 参数名 类型 说明 ::: code int 状态码，成功时为100000 message string 描述信息，成功时为success TaskID string 任务id 示例 请求路径：

接口功能介绍 支持查询直播截图用量。 使用说明 单个用户一分钟限制调用10000次，并发不超过100。 接口详情 请求方式：post 请求路径：/live/statistics/queryscreenshotdata 请求参数 参数名 类型 名称 是否必填 说明 ::::: starttime int 开始时间戳 是 起始时间，时间戳(秒) endtime int 结束时间戳 是 结束时间，时间戳(秒) interval string 时间粒度 否 时间间隔粒度，单位为s，只支持2种，5分钟（300）和一天（86400），默认300 domain list 域名列表 否 域名，默认名下所有域名，可多个域名 响应参数 参数名 类型 说明 ::: code int 状态码 message string 描述信息 starttime int 开始时间戳 endtime int 结束时间戳 interval string 时间粒度 reqscreenshotdatainterval list 每个时间间隔的截图张数 reqscreenshotdatainterval[].timestamp int 时间片开始时间戳 reqscreenshotdatainterval[].taskcount int 图片张数 示例 请求路径： 请求示例 { "starttime": 1655108160, "endtime": 1655111760 } 正常响应示例 { "message": "success", "starttime": 1655108160, "endtime": 1655111760, "interval": "5m", "reqscreenshotdatainterval": [ { "timestamp": 1655108400, "taskcount": 5 }, { "timestamp": 1655108100, "taskcount": 10 } ] } 错误码请参考：参数code和message含义

本文介绍配置生效时间。 当您对直播加速域名进行相关配置操作，预计需要5分钟~10分钟才能全局生效（如下图所示，当【状态】为【成功】即为生效）。您可通过控制台域名管理工单列表菜单，查询相关操作流程的最新状态。

本文说明闪断场景下的录制文件个数。 闪断时间如果是在“续录”设置的时间范围内，则会和之前录制文件合并为一个文件。 直播录制支持自定义续录时长，默认不续录，如需配置请提交工单。 说明 续录时长的配置范围为0~600s。

本文介绍录制纯音频文件的方法。 您可以通过如下两种方式配置录制文件输出为纯音频： 方式一：通过直播控制台配置。 1. 登录直播控制台。 2. 单击【功能配置】下方【直播录制】，进入【直播录制】配置页面。 3. 配置模板时，【录制格式】选为【aac】。 方式二：通过OpenAPI配置，详细操作请参见新增媒体处理模板。

为什么我上传的文件一直处于上传中? 为什么我上传的文件一直处于上传中？ 请排查是否由以下原因造成： 原因一：网络问题。请您首先确认上传主机的上行带宽是否充足。一般办公环境宽带为双向对等带宽，家庭宽带为不对等带宽（上行小，下行大），可能存在上行带宽不足或网络拥堵。您可以使用SpeedTEST等工具进行测试。 原因二：同时上传的文件数量过多。请确认上传文件大小以及处于“上传中”状态的时间是否处于合理范围。通过控制台、上传SDK等方式上传文件时，默认会使用分片上传，分片数量过大带宽过小可能会导致上传进度卡顿。

参数 是否必填 参数类型 说明 示例 下级对象 RecordTemplateId 是 String 模板id 717074786139029504

参数 是否必填 参数类型 说明 示例 下级对象 DeviceId 是 String 设备ID。 752657499261403136

参数 是否必填 参数类型 说明 示例 下级对象 DeviceId 是 String 设备ID。 752657499261403136

参数 参数类型 说明 示例 下级对象 statusCode Integer 响应状态码。 200 error String 错误码，执行成功时，不返回该字段。 VSS0001 message String 响应信息。 请求成功 requestId String 请求ID。 362d4e78556b47129182d0881fade86b returnObj Object 响应数据，执行失败时，不返回该字段。 returnObj

参数 参数类型 说明 示例 下级对象 DeviceId String 设备ID。 752657499261403136 RequestId String 请求ID。 20be6a0c4b0f42a288fb563c561d0a4c

参数 参数类型 说明 示例 下级对象 statusCode Integer 响应状态码。 200 error String 错误码，执行成功时，不返回该字段。 VSS0001 message String 响应信息。 请求成功 requestId String 请求ID。 362d4e78556b47129182d0881fade86b returnObj Object 响应数据，执行失败时，不返回该字段。 returnObj

参数 参数类型 说明 示例 下级对象 RequestId String 请求ID。 920844e56e6944e193da622fe222bcbc

参数 是否必填 参数类型 说明 示例 下级对象 DeviceId 是 String 设备ID。 752657499261403136

本文说明直播录制是否支持续录。 背景说明 当直播推流闪断并重新推一路流名相同直播流时，如果想要实现闪断前后直播流录制到同一个文件中，可通过续录功能来实现。 使用说明 直播录制支持对直播流进行续录。在未超出单个文件录制时长（hls默认为10s；flv、mp4以及纯音频默认为6小时）前提下，推流过程中如果出现断流，断流时间未超过设置的续录时长（例如180s），则录制过程中不会生成新的录制文件。 如果您需要自定义续录时长，请提交工单进行配置。

本文说明HTTPS请求可支持的范围。 HTTP协议以明文方式发送内容，不提供任何方式的数据加密。 HTTPS协议是以安全为目标的HTTP通道，简单来说，HTTPS是HTTP的安全版，即将HTTP用SSL/TLS协议进行封装，HTTPS的安全基础是SSL/TLS协议。 配置证书后，在原来基础上支持HTTPS访问，不影响原有的HTTP访问功能。 想要了解更多HTTPS信息，请参见HTTPS配置和证书配置。

本文介绍推流URL中的AppName和StreamName的格式限制。 AppName 发布点是指直播的应用名称，即直播流媒体文件的存放路径。 推流URL中的AppName，支持大小写字母、数字、下划线和中划线。 StreamName 流名即直播流名称，通常与域名和发布点一起唯一标识一路流。一般情况下流名不包含文件后缀。 推流URL中的StreamName，支持大小写字母、数字、下划线和中划线。

本文介绍判断直播生效的方法。 您可通过ping、dig等命令，测试加速域名的DNS解析结果。若域名解析结果为平台分配的CNAME地址，即说明配置成功，可实现全网加速生效。

本文简要介绍录制回调地址的配置方式。 您可以在直播控制台上自助配置录制回调地址。详细操作如下： 1. 登录直播控制台。 2. 单击【功能配置】下方【直播回调】，进入【直播回调】配置页面。 3. 配置【录制回调】地址并单击【保存】。更多信息请参见直播回调。

本文简述修改录制文件存储路径的方法。 您可以通过直播控制台或OpenAPI自助修改录制文件的存储路径。 通过直播控制台修改 详细操作如下： 1. 登录直播控制台。 2. 单击【功能配置】下方的【直播录制】。 3. 选择对应模板，修改【文件存储路径】并保存。 通过OpenAPI修改 详细操作请参见更新媒体处理模板。 说明 修改后的新路径只针对新推上来的流生效。

参数名 类型 说明 UniqName string 客户标识 StreamId string 流名 AppName string 应用名 FileFormat string 录制文件格式，支持hls，mp4，flv，aac StartTime string 录制文件开始时间，Unix 时间戳格式，例如：1653901448 EndTime string 录制文件结束时间，Unix 时间戳格式，例如：1653901448 Duration string 录制文件持续时间，单位为s（秒） FileSize int 录制文件大小，单位B VideoUrl string 录制文件路径

本文介绍直播录制的支持格式。 直播录制支持hls、flv、mp4和aac四种格式。如下图所示：

本文介绍如何配置录制文件的保持时长。 直播录制支持配置录制文件的保持时长。建议您登录存储控制台进行文件保持时长的相关配置。 注意 直播控制台中直播录制的保持时长，对应的是整个存储桶生命周期，所以请谨慎操作。

本文介绍如何获取直播截图的图片文件。 您可通过以下几种方式获取直播截图的图片文件 方式一：通过直播控制台获取截图文件保存路径，并登录存储控制台获取图片文件。详细操作如下： 1. 登录直播控制台。 2. 单击【功能配置】下方的【直播截图】。 3. 选择对应模板，查看【文件存储路径】以及对应的【存储区域】、【存储bucket】等相关信息。 4. 登录存储控制台，选择对应的存储区域和存储bucket，根据【文件存储路径】查看或下载对应的截图文件。更多详细信息请参见：管理对象。 方式二：通过截图回调信息获取截图文件 截图回调参数中的【PicUrl】参数即为截图文件的存储路径。

本文解释直播转码的计费规则。 直播转码根据输出的编码格式、输入分辨率和转码时长进行结算。即 标准直播转码费用 转码时长 × 对应编码方式和分辨率的价格。 直播转码目前仅支持标准转码和纯音频转码。 更多详细信息，请参见增值服务计费中的直播转码。

本文介绍使用OBS推流可能失败的原因。 使用OBS推流时，推流失败可能有多种原因导致。以下是一些常见的原因： 推流服务器配置错误：请确保您在OBS中正确配置了推流服务器的地址、端口和密钥等信息。检查您的配置是否与推流服务器的要求一致。 网络连接问题：推流过程中可能会出现网络连接问题，例如网络延迟、丢包等。请确保您的网络连接稳定，并尝试使用其他网络环境进行推流。 推流码率设置过高：如果您设置的推流码率过高，可能会导致推流失败。尝试降低推流码率，并确保它适合您的网络带宽。 推流设备问题：推流设备（例如摄像头、麦克风）可能存在问题，例如设备驱动程序不正确、设备与计算机的连接问题等。请检查设备是否正常工作，并在OBS中正确配置设备。 防火墙或安全软件阻止推流：某些防火墙或安全软件可能会阻止OBS进行推流。请确保您的防火墙或安全软件允许OBS进行网络连接和数据传输。 OBS版本不兼容：OBS的版本可能不兼容您的操作系统或其他相关软件。尝试升级到最新版本的OBS，并确保它与您的系统兼容。 直播服务器故障：直播服务器可能存在故障或维护。请通过工单与技术支持团队联系，确认服务器是否正常运行。 流在禁推列表中：如果流在禁推列表中，则也会导致推流失败。 如果您遇到推流失败的问题，建议您逐步排查以上可能的原因，并查看OBS的日志文件以获取更多详细信息。您还可以参考OBS的官方文档和社区论坛，寻求更多的技术支持和解决方案。