华为云用户手册

请求示例 修改直播拉流回源配置。 PUT https://{endpoint}/v1/{project_id}/domain/pull-sources { "play_domain" : "pull.example.test.com", "source_type" : "domain", "sources" : [ "example1.test.com", "example2.test.com" ], "scheme" : "http", "additional_args" : { "key1" : "value1", "key2" : "value2" } }

请求示例 创建录制回调配置。 POST https://{endpoint}/v1/{project_id}/record/callbacks { "publish_domain" : "publish.xxx.com", "app" : "**", "notify_callback_url" : "https://mycallback.com.cn/record_notify", "notify_event_subscription" : [ "RECORD_FILE_COMPLETE" ] }

响应参数 状态码： 201 表4 响应Header参数 参数 参数类型 描述 X-request-id String 此字段携带请求ID号，以便任务跟踪。格式为：request_id-timestamp-hostname（request_id在服务器端生成UUID，timestamp为当前时间戳，hostname为处理当前接口的服务器名称） 表5 响应Body参数 参数 参数类型 描述 id String 配置规则ID，在创建配置规则成功后服务端返回 publish_domain String 直播推流 域名 app String app名称。如果需要匹配任意应用则需填写*。录制规则匹配的时候，优先精确app匹配，如果匹配不到，则匹配* notify_callback_url String 录制回调通知url地址 notify_event_subscription Array of strings 订阅录制通知消息。消息类型。RECORD_NEW_FILE_START开始创建新的录制文件。RECORD_FILE_COMPLETE录制文件生成完成。RECORD_OVER录制结束。RECORD_FAILED表示录制失败。如果不填写,默认订阅RECORD_FILE_COMPLETE sign_type String 加密类型，包含如下取值 HMA CS HA256 MD5 create_time String 创建时间，格式：yyyy-mm-ddThh:mm:ssZ，UTC时间。 在查询的时候返回 update_time String 修改时间，格式：yyyy-mm-ddThh:mm:ssZ，UTC时间。 在查询的时候返回 状态码： 400 表6 响应Header参数 参数 参数类型 描述 X-request-id String 此字段携带请求ID号，以便任务跟踪。格式为：request_id-timestamp-hostname（request_id在服务器端生成UUID，timestamp为当前时间戳，hostname为处理当前接口的服务器名称） 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token，使用Token鉴权方式时必填。通过调用 IAM 服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Authorization 否 String 使用AK/SK方式认证时必填，携带的鉴权信息。 X-Sdk-Date 否 String 使用AK/SK方式认证时必填，请求的发生时间。 X-Project-Id 否 String 使用AK/SK方式认证时必填，携带项目ID信息。 表3 请求Body参数 参数 是否必选 参数类型 描述 publish_domain 是 String 直播推流域名 app 是 String app名称。如果需要匹配任意应用则需填写*。录制规则匹配的时候，优先精确app匹配，如果匹配不到，则匹配* notify_callback_url 否 String 录制回调通知url地址 notify_event_subscription 否 Array of strings 订阅录制通知消息。消息类型。RECORD_NEW_FILE_START开始创建新的录制文件。RECORD_FILE_COMPLETE录制文件生成完成。RECORD_OVER录制结束。RECORD_FAILED表示录制失败。如果不填写,默认订阅RECORD_FILE_COMPLETE sign_type 否 String 加密类型，包含如下取值 HMACSHA256 MD5 不填写时，取默认值HMACSHA256 key 否 String 回调秘钥，主要用于鉴权。为了保护用户数据信息安全，建议填写。

基本概念 账号 用户注册时的账号，账号对其所拥有的资源及云服务具有完全的访问权限，可以重置用户密码、分配用户权限等。由于账号是付费主体，为了确保账号安全，建议您不要直接使用账号进行日常管理工作，而是创建用户并使用创建的用户进行日常管理工作。 用户 由账号在IAM中创建的用户，是云服务的使用人员，具有身份凭证（密码和访问密钥）。 在我的凭证下，您可以查看账号ID和用户ID。通常在调用API的鉴权过程中，您需要用到账号、用户和密码等信息。 区域 指云资源所在的物理位置，同一区域内可用区间内网互通，不同区域间内网不互通。通过在不同地区创建云资源，可以将应用程序设计的更接近特定客户的要求，或满足不同地区的法律或其他要求。 可用区 一个可用区是一个或多个物理数据中心的集合，有独立的风火水电，AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连，以满足用户跨AZ构建高可用性系统的需求。 项目 区域默认对应一个项目，这个项目由系统预置，用来隔离物理区域间的资源（计算资源、存储资源和网络资源），以默认项目为单位进行授权，用户可以访问您账号中该区域的所有资源。如果您希望进行更加精细的权限控制，可以在区域默认的项目中创建子项目，并在子项目中购买资源，然后以子项目为单位进行授权，使得用户仅能访问特定子项目中资源，使得资源的权限控制更加精确。 图1 项目隔离模型 父主题： 使用前必读

请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token。使用Token鉴权方式时必选。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Authorization 否 String 使用AK/SK方式认证时必选，携带的鉴权信息。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选，请求的发生时间。 X-Project-Id 否 String 使用AK/SK方式认证时必选，携带项目ID信息, 与路径参数中的项目ID相同。

响应参数 状态码： 200 表4 响应Header参数 参数 参数类型 描述 X-Request-Id String 请求的唯一标识。 表5 响应Body参数 参数 参数类型 描述 data_list Array of V2UserData objects 观众趋势列表。 表6 V2UserData 参数 参数类型 描述 value Long 采样点观众数。 time String 采样时间。日期格式按照ISO8601表示法，并使用UTC时间。 格式为：YYYY-MM-DDThh:mm:ssZ。 状态码： 400 表7 响应Header参数 参数 参数类型 描述 X-Request-Id String 请求的唯一标识。 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。

响应示例 状态码： 200 处理成功返回。 { "data_list" : [ { "value" : 50, "time" : "2020-06-04T07:00:00Z" }, { "value" : 60, "time" : "2020-06-04T07:01:00Z" } ] } 状态码： 400 处理失败返回。 { "error_code" : "LIVE.100011001", "error_msg" : "Invalid request parameter: play_domain" }

URI GET /v2/{project_id}/stats/user 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。获取方法请参考获取项目ID。 表2 Query参数 参数 是否必选 参数类型 描述 play_domain 是 String 播放域名。 app 否 String app名。 stream 否 String 流名。 isp 否 Array 运营商列表，取值如下： CMCC ：移动 CTCC ： 电信 CUCC ：联通 OTHER ：其他 不填写查询所有运营商。 country 否 Array 国家列表。具体取值请参考国家名称缩写，不填写查询所有国家。 region 否 Array 区域列表。具体取值请参考省份名称缩写，不填写查询所有区域。 protocol 否 String 请求协议 interval 否 Integer 查询数据的时间粒度，支持60（默认值）, 300秒。不传值时，使用默认值60秒。 start_time 否 String 起始时间。日期格式按照ISO8601表示法，并使用UTC时间。 格式为：YYYY-MM-DDThh:mm:ssZ。最大查询跨度31天，最大查询周期一年。 若参数为空，默认查询7天数据。 end_time 否 String 结束时间。日期格式按照ISO8601表示法，并使用UTC时间。格式为：YYYY-MM-DDThh:mm:ssZ。 若参数为空，默认为当前时间。结束时间需大于起始时间。 service_type 否 String 服务类型，取值如下： Live ：标准直播 LLL ：低时延直播 ALL ：所有服务类型 不填写默认查询所有服务类型的数据。 说明： 该参数只对2022年12月15日后的数据生效。

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 push_domain String 推流域名 application Array of PushDomainApplication objects 推流域名APP配置 表5 PushDomainApplication 参数 参数类型 描述 name String 应用名，默认为live hls_fragment Integer HLS切片时长，单位：s。 hls_ts_count Integer 每个M3U8文件内ts切片个数 hls_min_frags Integer 每个M3U8文件内最小ts分片数 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述

请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token，使用Token鉴权方式时必填。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Authorization 否 String 使用AK/SK方式认证时必填，携带的鉴权信息。 X-Sdk-Date 否 String 使用AK/SK方式认证时必填，请求的发生时间。 X-Project-Id 否 String 使用AK/SK方式认证时必填，携带项目ID信息。

响应示例 状态码： 200 查询推流域名HLS配置成功 { "push_domain" : "push.example.com", "application" : [ { "name" : "live", "hls_fragment" : 2, "hls_ts_count" : 3, "hls_min_frags" : 3 } ] } 状态码： 400 参数错误 { "error_code" : "LIVE.100011001", "error_msg" : "Request Illegal" }

响应示例 状态码： 200 查询直播播放在线人数成功 { "total" : 1, "user_info" : [ { "user_num" : 1024, "timestamp" : "2018-05-19T21:10:15Z" } ] } 状态码： 400 查询直播播放在线人数失败 { "error_code" : "LIVE.100011001", "error_msg" : "Request Illegal" }

URI GET /v1/{project_id}/stream/users 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，获取方法请参考获取项目ID。 表2 Query参数 参数 是否必选 参数类型 描述 domain 是 String 直播播放域名 app_name 否 String 应用名称 stream_name 否 String 流名称 start_time 否 String 查询开始时间，UTC时间，格式：yyyy-mm-ddThh:mm:ssZ。 无开始时间表示查询最近统计周期在线人数数据 只能查询最近90天内的数据 end_time 否 String 查询结束时间，UTC时间，格式：yyyy-MM-ddTHH:mm:ssZ。 start_time与end_time均不存在时，服务端从最近一个统计周期的数据里查询。 start_time存在、end_time不存在时，end_time取当前时间。 start_time不存在、end_time存在时，请求非法。 只能查询最近90天内的数据，start_time和end_time的跨度不能大于30天。 step 否 Integer 统计周期。 单位：分钟, 最大为30天，且小于查询开始时间与结束时间的差值

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 total Integer 查询结果的总元素数量 user_info Array of UserInfo objects 正在推流的音视频信息 表5 UserInfo 参数 参数类型 描述 user_num Integer 直播流的在线人数 timestamp String 操作执行的时间，UTC时间，格式：yyyy-MM-ddTHH:mm:ssZ 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述

响应示例 状态码： 200 查询直播截图配置操作成功 { "total" : 2, "offset" : 0, "limit" : 10, "snapshot_config_list" : [ { "domain" : "testsnapshot.huawei.com", "app_name" : "live", "time_interval" : 5, "object_write_mode" : 1, "obs_location" : { "bucket" : "obs-d95a", "location" : "region1", "object" : "test1/" } }, { "domain" : "testsnapshot.huawei.com", "app_name" : "src", "time_interval" : 5, "object_write_mode" : 1, "obs_location" : { "bucket" : "obs-d95a", "location" : "region1", "object" : "test2/" } } ] } 状态码： 400 查询直播截图配置操作失败 { "error_code" : "LIVE.100011001", "error_msg" : "Request Illegal" }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 total Integer 总条目数 snapshot_config_list Array of LiveSnapshotConfig objects 截图配置 limit Integer 每页记录数 offset Integer 偏移量 表5 LiveSnapshotConfig 参数 参数类型 描述 domain String 直播推流域名 app_name String 应用名称 auth_key String 回调鉴权密钥值 长度范围：[32-128] 若需要使用回调鉴权功能，请配置鉴权密钥，否则，留空即可。 time_interval Integer 截图频率 取值范围：[5-3600] 单位：秒 object_write_mode Integer 在OBS桶存储截图的方式： 0：实时截图，以时间戳命名截图文件，保存所有截图文件到OBS桶。例：snapshot/{domain}/{app_name}/{stream_name}/{UnixTimestamp}.jpg 1：覆盖截图，只保存最新的截图文件，新的截图会覆盖原来的截图文件。例：snapshot/{domain}/{app_name}/{stream_name}.jpg obs_location ObsFileAddr object OBS存储位置信息 call_back_enable String 是否启用回调通知 on：启用。 off：不启用。 call_back_url String 通知服务器地址，必须是合法的URL且携带协议，协议支持http和https。截图完成后直播服务会向此地址推送截图状态信息。 表6 ObsFileAddr 参数 参数类型 描述 bucket String OBS的bucket名称 location String OBS Bucket所在的区域，且必须保持与使用的直播服务区域保持一致。 object String OBS对象路径，遵守OSS Object定义 当用于指示input时，需要指定到具体对象 当用于指示output时，只需指定到截图结果期望存放的路径 状态码： 400 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述

URI GET /v1/{project_id}/stream/snapshot 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，获取方法请参考获取项目ID。 表2 Query参数 参数 是否必选 参数类型 描述 domain 是 String 域名 app_name 否 String 应用名称 limit 否 Integer 每页记录数 取值范围[1,100] 默认值：10 offset 否 Integer 偏移量，表示从此偏移量开始查询，offset大于等于0

请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token，使用Token鉴权方式时必填。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Authorization 否 String 使用AK/SK方式认证时必填，携带的鉴权信息。 X-Sdk-Date 否 String 使用AK/SK方式认证时必填，请求的发生时间。 X-Project-Id 否 String 使用AK/SK方式认证时必填，携带项目ID信息。

请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token，使用Token鉴权方式时必填。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Authorization 否 String 使用AK/SK方式认证时必填，携带的鉴权信息。 X-Sdk-Date 否 String 使用AK/SK方式认证时必填，请求的发生时间。 X-Project-Id 否 String 使用AK/SK方式认证时必填，携带项目ID信息。

请求示例 修改域名HLS配置。 PUT https://{endpoint}/v1/{project_id}/domain/hls { "push_domain" : "push.example.com", "application" : [ { "name" : "live", "hls_fragment" : 2, "hls_ts_count" : 3, "hls_min_frags" : 3 } ] }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token，使用Token鉴权方式时必填。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Authorization 否 String 使用AK/SK方式认证时必填，携带的鉴权信息。 X-Sdk-Date 否 String 使用AK/SK方式认证时必填，请求的发生时间。 X-Project-Id 否 String 使用AK/SK方式认证时必填，携带项目ID信息。 表3 请求Body参数 参数 是否必选 参数类型 描述 push_domain 是 String 推流域名 application 是 Array of PushDomainApplication objects 推流域名APP配置 表4 PushDomainApplication 参数 是否必选 参数类型 描述 name 否 String 应用名，默认为live hls_fragment 否 Integer HLS切片时长，单位：s。 hls_ts_count 否 Integer 每个M3U8文件内ts切片个数 hls_min_frags 否 Integer 每个M3U8文件内最小ts分片数

响应参数 状态码： 200 表5 响应Body参数 参数 参数类型 描述 push_domain String 推流域名 application Array of PushDomainApplication objects 推流域名APP配置 表6 PushDomainApplication 参数 参数类型 描述 name String 应用名，默认为live hls_fragment Integer HLS切片时长，单位：s。 hls_ts_count Integer 每个M3U8文件内ts切片个数 hls_min_frags Integer 每个M3U8文件内最小ts分片数 状态码： 400 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述

调用API获取项目ID 您还能通过调用查询指定条件下的项目信息API获取项目ID。 获取项目ID的接口为“GET https://{Endpoint}/v3/projects/”，其中{Endpoint}为IAM的终端节点可以从地区和终端节点获取。接口的认证鉴权请参见认证鉴权。 响应示例如下，其中projects下的“id”即为项目ID。 { "projects": [ { "domain_id": "65382450e8f64ac0870cd180d14e684b", "is_domain": false, "parent_id": "65382450e8f64ac0870cd180d14e684b", "name": "region01", "description": "", "links": { "next": null, "previous": null, "self": "https://www.example.com/v3/projects/a4a5d4098fb4474fa22cd05f897d6b99" }, "id": "a4a5d4098fb4474fa22cd05f897d6b99", "enabled": true } ], "links": { "next": null, "previous": null, "self": "https://www.example.com/v3/projects" } }

响应示例 状态码： 400 操作失败 { "error_code" : "LIVE.100011001", "error_msg" : "Request Illegal" } 状态码： 404 记录不存在 { "error_code" : "LIVE.100011001", "error_msg" : "The resource to access is not exists" }

响应参数 状态码： 200 表5 响应Header参数 参数 参数类型 描述 X-request-id String 此字段携带请求ID号，以便任务跟踪。格式为：request_id-timestamp-hostname（request_id在服务器端生成UUID，timestamp为当前时间戳，hostname为处理当前接口的服务器名称） 状态码： 400 表6 响应Header参数 参数 参数类型 描述 X-request-id String 此字段携带请求ID号，以便任务跟踪。格式为：request_id-timestamp-hostname（request_id在服务器端生成UUID，timestamp为当前时间戳，hostname为处理当前接口的服务器名称 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 404 表8 响应Header参数 参数 参数类型 描述 X-request-id String 此字段携带请求ID号，以便任务跟踪。 格式为 request_id-timestamp-hostname(request_id在服务器端生成UUID， timestamp为当前时间戳，hostname为处理当前接口的服务器名称) 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述

URI POST /v1/{project_id}/record/control 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，获取方法请参考获取项目ID。 表2 Query参数 参数 是否必选 参数类型 描述 action 是 String 操作行为。 (在停止录制命令下发之后，再次对相同流下发开始录制命令的时间间隔必须在10秒以上) 取值如下： START：对指定流开始录制，必须在直播流已经推送情况下才能正常启动，使用此命令启动录制的直播流如果发生了断流且超出断流时长，就会停止录制，并且重新推流后不会自动启动录制。 STOP：对指定流停止录制。

请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token，使用Token鉴权方式时必填。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Authorization 否 String 使用AK/SK方式认证时必填，携带的鉴权信息。 X-Sdk-Date 否 String 使用AK/SK方式认证时必填，请求的发生时间。 X-Project-Id 否 String 使用AK/SK方式认证时必填，携带项目ID信息。 表4 请求Body参数 参数 是否必选 参数类型 描述 publish_domain 是 String 直播推流域名 app 是 String 应用名 stream 是 String 待启动或停止录制的流名

请求示例 修改禁止直播推流属性。 POST https://{endpoint}/v1/{project_id}/stream/blocks { "domain" : "publish.example.huawei.com", "app_name" : "live", "stream_name" : "huawei", "resume_time" : "2018-05-19T21:10:15Z" }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token，使用Token鉴权方式时必填。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Authorization 否 String 使用AK/SK方式认证时必填，携带的鉴权信息。 X-Sdk-Date 否 String 使用AK/SK方式认证时必填，请求的发生时间。 X-Project-Id 否 String 使用AK/SK方式认证时必填，携带项目ID信息。 表3 请求Body参数 参数 是否必选 参数类型 描述 domain 是 String 推流域名 app_name 是 String 应用名称 trans_type 否 String 转码流触发模式。 play：拉流触发转码。 publish：推流触发转码。 默认为play quality_info 是 Array of QualityInfo objects 视频质量信息 表4 QualityInfo 参数 是否必选 参数类型 描述 quality 是 String 包含如下取值： lud：超高清，系统缺省名称。 lhd：高清，系统缺省名称。 lsd：标清，系统缺省名称。 lld：流畅，系统缺省名称。 userdefine：视频质量自定义。填写userdefine时，templateName字段不能为空。 templateName 否 String 自定义模板名称。 若需要自定义模板名称，请将quality参数设置为userdefine。 多个自定义模板名称之间不能重复。 自定义模板名称不能与其他模板的quality参数重复。 若quality不为userdefine，请勿填写此字段。 PVC 否 String 是否使用窄带高清转码。 注意：该字段已不再维护，建议使用hdlb。 包含如下取值： off：不启用。 on：启用。 默认值：off。 hdlb 否 String 是否启用高清低码，较PVC相比画质增强。 提示：使用hdlb字段开启高清低码时，PVC字段不生效。 包含如下取值： off：不开启高清低码。 on：开启高清低码。 默认值：off。 codec 否 String 视频编码格式。 包含如下取值： H264：使用H.264。 H265：使用H.265。 默认为H264。 width 否 Integer 视频的长边。其中，横屏为宽，即长边，竖屏为高。单位：像素。 包含如下取值： codec的取值为H264时，width建议取值范围为[32,3840]，且必须为2整数倍。 codec的取值为H265时，width建议取值范围为[320,3840]，且必须为2的整数倍。 注意：width和height全为0时，输出的分辨率和源保持一致；width和height只有一个为0时，输出的分辨率按非0项的比例进行缩放。 默认值：0。 height 否 Integer 视频的短边。其中，横屏为宽，竖屏为高，即短边。单位：像素。 包含如下取值： codec的取值为H264时，height建议取值范围为[32,2160]，且必须为2的整数倍。 codec的取值为H265时，height建议取值范围为[240,2160]，且必须为2的整数倍。 注意：width和height全为0时，输出的分辨率和源保持一致；width和height只有一个为0时，输出的分辨率按非0项的比例进行缩放。 默认值：0。 bitrate 是 Integer 转码视频的码率。 单位：Kbps 取值范围：40-30000。 video_frame_rate 否 Integer 转码视频帧率。 单位：fps 取值范围：0-60，0表示保持帧率不变。 默认值：0。 protocol 否 String 转码输出支持的协议类型。默认为RTMP。当前只支持RTMP。 包含如下取值： RTMP iFrameInterval 否 Integer 最大I帧间隔。 单位：帧数 取值范围：[0, 500]，默认值：50。 注意：若希望通过iFrameInterval设置i帧间隔，请将gop设为0，或不传gop参数。 gop 否 Integer 按时间设置I帧间隔。 单位：秒 取值范围：[0,10]，默认值：2。 注意：gop不为0时，则以gop设置i帧间隔，iFrameInterval字段不生效。 bitrate_adaptive 否 String 自适应码率参数。 包含如下取值： off：关闭码率自适应，目标码率按设定的码率输出。 minimum：目标码率按设定码率和源文件码率最小值输出（即码率不上扬）。 adaptive：目标码率按源文件码率自适应输出。 默认值：off。 i_frame_policy 否 String 编码输出I帧策略。 包含如下取值： auto：I帧按设置的gop时长输出。 strictSync：编码输出I帧完全和源保持一致（源是I帧则编码输出I帧，源不是I帧则编码非I帧），设置该参数后gop时长设置无效。 默认值：auto。 注意：多码率场景下建议开启I帧随源，保障多码率I帧对齐。