华为云用户手册

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token，使用Token鉴权方式时必选。通过调用 IAM 服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Access-Control-Allow-Internal 否 String 服务鉴权Token，服务开启鉴权，必须携带Access-Control-Allow-Internal访问服务。 Access-Control-Allow-External 否 String 服务鉴权Token，服务开启鉴权，必须携带Access-Control-Allow-External访问服务。 表3 请求Body参数 参数 是否必选 参数类型 描述 domain 是 String 频道推流 域名 app_name 是 String 组名或应用名 id 是 String 频道ID。频道唯一标识，为必填项。 state 是 String 频道状态 ON：频道下发成功后，自动启动拉流、转码、录制等功能 OFF：仅保存频道信息，不启动频道

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 result_code String 错误码 result_msg String 错误描述 domain String 推流域名 app_name String 组名或应用名，为必填项 id String 频道ID。频道唯一标识，为必填项 sources Array of SourceRsp objects 推流URL列表。创建频道时，只有入流协议为RTMP_PUSH时，会返回推流URL列表 表5 SourceRsp 参数 参数类型 描述 url String RTMP推流地址 bitrate Integer 码率。 单位：bps。取值范围：(0,104,857,600]（100Mbps） width Integer 分辨率对应宽的值。取值范围：0 - 4096（4K） height Integer 分辨率对应高的值。取值范围：0 - 2160（4K） enable_snapshot Boolean 描述是否使用该流做截图 状态码： 400 表6 响应Body参数 参数 参数类型 描述 result_code String 错误码 result_msg String 错误描述 domain String 推流域名 app_name String 组名或应用名，为必填项 id String 频道ID。频道唯一标识，为必填项

请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token，使用Token鉴权方式时必选。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Access-Control-Allow-Internal 否 String 服务鉴权Token，服务开启鉴权，必须携带Access-Control-Allow-Internal访问服务。 Access-Control-Allow-External 否 String 服务鉴权Token，服务开启鉴权，必须携带Access-Control-Allow-External访问服务。

响应示例 状态码： 200 Demo Information { "result_code" : "LIVE.100000000", "result_msg" : "SUC CES S", "domain" : "push.testott.hls.com", "app_name" : "ott", "id" : "test" } 状态码： 400 Error response { "result_code" : "LIVE.103011019", "result_msg" : "The resource to access is not exists", "domain" : "push.testott.hls.com", "app_name" : "ott", "id" : "test" }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 result_code String 错误码 result_msg String 错误描述 domain String 推流域名 app_name String 组名或应用名，为必填项 id String 频道ID。频道唯一标识，为必填项 状态码： 400 表5 响应Body参数 参数 参数类型 描述 result_code String 错误码 result_msg String 错误描述 domain String 推流域名 app_name String 组名或应用名，为必填项 id String 频道ID。频道唯一标识，为必填项

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 result_code String 错误码 result_msg String 错误描述 domain String 推流域名 app_name String 组名或应用名，为必填项 id String 频道ID。频道唯一标识，为必填项 sources Array of SourceRsp objects 推流URL列表。创建频道时，只有入流协议为RTMP_PUSH时，会返回推流URL列表 表5 SourceRsp 参数 参数类型 描述 url String RTMP推流地址 bitrate Integer 码率。 单位：bps。取值范围：(0,104,857,600]（100Mbps） width Integer 分辨率对应宽的值。取值范围：0 - 4096（4K） height Integer 分辨率对应高的值。取值范围：0 - 2160（4K） enable_snapshot Boolean 描述是否使用该流做截图 状态码： 400 表6 响应Body参数 参数 参数类型 描述 result_code String 错误码 result_msg String 错误描述 domain String 推流域名 app_name String 组名或应用名，为必填项 id String 频道ID。频道唯一标识，为必填项

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token，使用Token鉴权方式时必选。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Access-Control-Allow-Internal 否 String 服务鉴权Token，服务开启鉴权，必须携带Access-Control-Allow-Internal访问服务。 Access-Control-Allow-External 否 String 服务鉴权Token，服务开启鉴权，必须携带Access-Control-Allow-External访问服务。 表3 请求Body参数 参数 是否必选 参数类型 描述 domain 是 String 频道推流域名 app_name 是 String 组名或应用名 id 是 String 频道ID。频道唯一标识，为必填项 name 是 String 频道名称

响应示例 状态码： 200 Demo Information { "result_code" : "LIVE.100000000", "result_msg" : "SUCCESS", "domain" : "push.testott.hls.com", "app_name" : "ott", "id" : "test" } 状态码： 400 Error response { "result_code" : "LIVE.103011019", "result_msg" : "The resource to access is not exists", "domain" : "push.testott.hls.com", "app_name" : "ott", "id" : "test22" }

响应示例 状态码： 201 Demo Information { "result_code" : "LIVE.100000000", "result_msg" : "SUCCESS", "domain" : "push.testott.hls.com", "app_name" : "ott", "id" : "test", "sources" : [ { "url" : "rtmp://push.testott.hls.com/ott/test_1024?request_source=ott&channel_id=test", "bitrate" : 1024, "width" : 100, "height" : 100 } ] } 状态码： 400 Error response { "result_code" : "LIVE.100011001", "result_msg" : "output url pull.testott.hls.com/ott/test/index.m3u8 is exist", "domain" : "push.testott.hls.com", "app_name" : "ott", "id" : "test" }

响应参数 状态码： 201 表28 响应Body参数 参数 参数类型 描述 result_code String 错误码 result_msg String 错误描述 domain String 推流域名 app_name String 组名或应用名，为必填项 id String 频道ID。频道唯一标识，为必填项 sources Array of SourceRsp objects 推流URL列表。创建频道时，只有入流协议为RTMP_PUSH时，会返回推流URL列表 表29 SourceRsp 参数 参数类型 描述 url String RTMP推流地址 bitrate Integer 码率。 单位：bps。取值范围：(0,104,857,600]（100Mbps） width Integer 分辨率对应宽的值。取值范围：0 - 4096（4K） height Integer 分辨率对应高的值。取值范围：0 - 2160（4K） enable_snapshot Boolean 描述是否使用该流做截图 状态码： 400 表30 响应Body参数 参数 参数类型 描述 result_code String 错误码 result_msg String 错误描述 domain String 推流域名 app_name String 组名或应用名，为必填项 id String 频道ID。频道唯一标识，为必填项

请求示例 POST https://{endpoint}/v1/{project_id}/ott/channels { "domain" : "push.testott.hls.com", "app_name" : "ott", "id" : "test", "name" : "testname", "input" : { "input_protocol" : "FLV_PULL", "sources" : [ { "url" : "http://192.168.0.1/ott/test.flv?vhost=pull.testott.hls.com", "bitrate" : 1024, "width" : 100, "height" : 100 } ], "failover_conditions" : { "input_loss_threshold_msec" : 100, "input_preference" : "EQUAL" } }, "record_settings" : { "rollingbuffer_duration" : 86400 }, "endpoints" : [ { "hls_package" : [ { "url" : "pull.testott.hls.com/ott/test/index.m3u8", "stream_selection" : [ { "key" : "sss", "max_bandwidth" : 100, "min_bandwidth" : 100 } ], "hls_version" : "1", "segment_duration_seconds" : 4, "playlist_window_seconds" : 3600 } ], "dash_package" : [ { "url" : "pull.testott.hls.com/ott/test/index.mpd", "stream_selection" : [ { "key" : "bitrate=900000-1800000", "max_bandwidth" : 1800000, "min_bandwidth" : 900000 } ], "segment_duration_seconds" : 4, "playlist_window_seconds" : 3600 } ], "mss_package" : [ { "url" : "pull.testott.hls.com/ott/channel/manifest", "stream_selection" : [ { "key" : "bitrate=900000-1800000", "max_bandwidth" : 1800000, "min_bandwidth" : 900000 } ], "segment_duration_seconds" : 4, "playlist_window_seconds" : 3600 } ] } ], "state" : "OFF" }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token，使用Token鉴权方式时必选。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Access-Control-Allow-Internal 否 String 服务鉴权Token，服务开启鉴权，必须携带Access-Control-Allow-Internal访问服务。 Access-Control-Allow-External 否 String 服务鉴权Token，服务开启鉴权，必须携带Access-Control-Allow-External访问服务。 表3 请求Body参数 参数 是否必选 参数类型 描述 domain 是 String 频道推流域名 app_name 是 String 组名或应用名 id 是 String 频道ID。频道唯一标识，为必填项。 name 否 String 频道名。可选配置 state 是 String 频道状态 ON：频道下发成功后，自动启动拉流、转码、录制等功能 OFF：仅保存频道信息，不启动频道 input 是 InputStreamInfo object 频道入流信息 encoder_settings 否 Array of encoder_settings objects 转码模板配置 record_settings 是 record_settings object 回看录制的配置信息。 endpoints 是 Array of EndpointItem objects 频道出流信息 encoder_settings_expand 否 EncoderSettingsExpand object 音频输出配置 表4 InputStreamInfo 参数 是否必选 参数类型 描述 input_protocol 是 String 频道入流协议 FLV_PULL RTMP_PUSH HLS_PULL SRT_PULL SRT_PUSH sources 否 Array of SourcesInfo objects 频道主源流信息。入流协议为RTMP_PUSH和SRT_PUSH时，非必填项。其他情况下，均为必填项。 secondary_sources 否 Array of SecondarySourcesInfo objects 备入流数组，非必填项。如果有备入流，则主备入流必须保证路数、codec和分辨率均一致。入流协议为RTMP_PUSH时，无需填写。 failover_conditions 否 FailoverConditions object 非必填，频道供应商提供的主备音视频流URL切换的配置。 max_bandwidth_limit 否 Integer 当入流协议为HLS_PULL时，需要配置的最大带宽。 用户提供的拉流URL中，针对不同码率的音视频，均会携带带宽参数“BANDW IDT H”。 如果这里配置最大带宽，媒体直播服务从URL拉流时，会选择小于最大带宽且码率最大的音视频流，推流到源站。 如果这里未配置最大带宽，媒体直播服务从URL拉流时，会默认选择“BANDWIDTH”最高的音视频流，推流到源站。 ip_port_mode 否 Boolean 当推流协议为SRT_PUSH时，如果配置了直推源站，编码器不支持输入streamid，需要打开设置为true ip_whitelist 否 String SRT_PUSH类型时，客户push ip白名单 scte35_source 否 String 广告的scte35信号源。 仅HLS_PULL类型的频道支持此配置，且目前仅支持SEGMENTS。 ad_triggers 否 Array of strings 广告触发器配置。 包含如下取值： Splice insert：拼接插入 Provider advertisement：提供商广告 Distributor advertisement：分销商广告 Provider placement opportunity：提供商置放机会 Distributor placement opportunity：分销商置放机会 audio_selectors 否 Array of InputAudioSelector objects 设置音频选择器，最多设置8个音频选择器 表5 SourcesInfo 参数 是否必选 参数类型 描述 url 否 String 频道源流URL，用于外部拉流 bitrate 否 Integer 码率。无需直播转码时，此参数为必填项 单位：bps。取值范围：(0,104,857,600]（100Mbps） width 否 Integer 分辨率对应宽的值，非必填项 取值范围：0 - 4096（4K） height 否 Integer 分辨率对应高的值，非必填项 取值范围：0 - 2160（4K） enable_snapshot 否 Boolean 描述是否使用该流做截图 bitrate_for3u8 否 Boolean 是否使用bitrate来固定码率。默认值：false passphrase 否 String 协议为SRT_PUSH时的加密信息 backup_urls 否 Array of strings 备入流地址列表 stream_id 否 String 频道为SRT_PULL类型时，拉流地址的Stream ID。 latency 否 Integer 频道为SRT_PULL类型时的拉流时延。 表6 SecondarySourcesInfo 参数 是否必选 参数类型 描述 url 否 String 频道源流URL，用于外部拉流 bitrate 否 Integer 码率。无需直播转码时，此参数为必填项 单位：bps。取值范围：(0,104,857,600]（100Mbps） width 否 Integer 分辨率对应宽的值，非必填项 取值范围：0 - 4096（4K） height 否 Integer 分辨率对应高的值，非必填项 取值范围：0 - 2160（4K） bitrate_for3u8 否 Boolean 是否使用bitrate来固定码率。默认值：false passphrase 否 String 协议为SRT_PUSH时的加密信息 backup_urls 否 Array of strings 备入流地址列表 stream_id 否 String 频道为SRT_PULL类型时，拉流地址的Stream ID。 latency 否 Integer 频道为SRT_PULL类型时的拉流时延。 表7 FailoverConditions 参数 是否必选 参数类型 描述 input_loss_threshold_msec 否 Integer 入流停止的时长阈值。到达此阈值后，自动触发主备切换。 单位：毫秒，取值范围：0 - 3600000。 非必填，默认填2000ms。 input_preference 否 String 以主入流URL为第一优先级（PRIMARY）或主备URL平等切换（EQUAL）。 如果是平等切换时，使用的是备URL，不会自动切换至主URL。 非必填，默认值为EQUAL。 表8 InputAudioSelector 参数 是否必选 参数类型 描述 name 是 String 音频选择器的名称。仅支持大小写字母、数字、中划线和下划线。 同一个频道中每个选择器的名称需要唯一。 selector_settings 否 AudioSelectorSettings object 设置音频选择器 表9 AudioSelectorSettings 参数 是否必选 参数类型 描述 audio_language_selection 否 AudioSelectorLangSelection object 设置语言选择器 audio_pid_selection 否 AudioSelectorPidSelection object 设置PID选择器 audio_hls_selection 否 AudioSelectorHlsSelection object 设置Hls选择器 表10 AudioSelectorLangSelection 参数 是否必选 参数类型 描述 language_code 是 String 语言简称，输入2或3个小写字母的语言代码。 language_selection_policy 否 String 语言输出策略。 取值如下： LOOSE：宽松匹配，示例“eng”会优先匹配源流中语言为English的音轨，如果匹配不到，则选择PID最小的音轨。 STRICT：严格匹配，示例“eng”会严格匹配源流中语言为English的音轨，如果匹配不到，媒体直播服务会自动补齐一个静音分片，当终端使用此音频选择器播放视频时，会静音播放。 表11 AudioSelectorPidSelection 参数 是否必选 参数类型 描述 pid 是 Integer 设置PID的值 表12 AudioSelectorHlsSelection 参数 是否必选 参数类型 描述 name 是 String hls音频选择器名 group_id 是 String hls音频选择器gid 表13 encoder_settings 参数 是否必选 参数类型 描述 template_id 否 String 转码模板ID 表14 record_settings 参数 是否必选 参数类型 描述 rollingbuffer_duration 是 Integer 最大回看录制时长。在此时间段内会连续不断的录制，为必选项 单位：秒。取值为“0”时，表示不支持录制；最大支持录制14天 表15 EndpointItem 参数 是否必选 参数类型 描述 hls_package 否 Array of HlsPackageItem objects HLS打包信息 dash_package 否 Array of DashPackageItem objects DASH打包信息 mss_package 否 Array of MssPackageItem objects MSS打包信息 表16 HlsPackageItem 参数 是否必选 参数类型 描述 url 是 String 客户自定义的拉流地址，包括方法、域名、路径 stream_selection 否 Array of StreamSelectionItem objects 从全量流中过滤出一个码率在[min, max]区间的流。如果不需要码率过滤可不选。 hls_version 否 String HLS版本号 segment_duration_seconds 是 Integer 频道输出分片的时长，为必选项 单位：秒。取值范围：1-10 说明： 修改分片时长会影响已录制内容的时移和回看服务，请谨慎修改！ playlist_window_seconds 否 Integer 频道直播返回分片的窗口长度，为频道输出分片的时长乘以数量后得到的值。实际返回的分片数不小于3个。 单位：秒。取值范围：0 - 86400（24小时转化成秒后的取值） encryption 否 Encryption object 加密信息 ads 否 Object 广告配置 ext_args 否 Object 其他额外参数 request_args 否 PackageRequestArgs object 播放相关配置 ad_marker 否 Array of strings 广告标识。 HLS取值：["ENHANCED_SCTE35"]。 表17 DashPackageItem 参数 是否必选 参数类型 描述 url 是 String 客户自定义的拉流地址，包括方法、域名、路径 stream_selection 否 Array of StreamSelectionItem objects 从全量流中过滤出一个码率在[min, max]区间的流。如果不需要码率过滤可不选。 segment_duration_seconds 是 Integer 频道输出分片的时长，为必选项 单位：秒。取值范围：1-10 说明： 修改分片时长会影响已录制内容的时移和回看服务，请谨慎修改！ playlist_window_seconds 否 Integer 频道直播返回分片的窗口长度，为频道输出分片的时长乘以数量后得到的值。实际返回的分片数不小于3个。 单位：秒。取值范围：0 - 86400（24小时转化成秒后的取值） encryption 否 Encryption object 加密信息 ads 否 Object 广告配置 ext_args 否 Object 其他额外参数 request_args 否 PackageRequestArgs object 播放相关配置 ad_marker 否 String 广告标识。 DASH取值："xml+bin"。 表18 MssPackageItem 参数 是否必选 参数类型 描述 url 是 String 客户自定义的拉流地址，包括方法、域名、路径 stream_selection 否 Array of StreamSelectionItem objects 从全量流中过滤出一个码率在[min, max]区间的流。如果不需要码率过滤可不选。 segment_duration_seconds 是 Integer 频道输出分片的时长，为必选项 单位：秒。取值范围：1-10 说明： 修改分片时长会影响已录制内容的时移和回看服务，请谨慎修改！ playlist_window_seconds 否 Integer 频道直播返回分片的窗口长度，为频道输出分片的时长乘以数量后得到的值。实际返回的分片数不小于3个。 单位：秒。取值范围：0 - 86400（24小时转化成秒后的取值） encryption 否 Encryption object 加密信息 ext_args 否 Object 其他额外参数 delay_segment 否 Integer 延播时长，单位秒 request_args 否 PackageRequestArgs object 播放相关配置 表19 StreamSelectionItem 参数 是否必选 参数类型 描述 key 否 String 拉流URL中用于码率过滤的参数 max_bandwidth 否 Integer 最大码率，单位：bps 取值范围：0 - 104,857,600（100Mbps） min_bandwidth 否 Integer 最小码率，单位：bps 取值范围：0 - 104,857,600（100Mbps） 表20 Encryption 参数 是否必选 参数类型 描述 key_rotation_interval_seconds 否 Integer 密钥缓存时间。如果密钥不变，默认缓存七天。 请注意：目前为保留字段，不支持配置。 encryption_method 否 String 加密方式。 请注意：目前为保留字段，不支持配置。 level 否 String 取值如下： content：一个频道对应一个密钥 profile：一个码率对应一个密钥 默认值：content resource_id 是 String 客户生成的DRM内容ID system_ids 是 Array of strings system_id枚举值。 取值如下： HLS：FairPlay DASH：Widevine、PlayReady MSS：PlayReady url 是 String 获取密钥的DRM地址 speke_version 是 String drm speke 版本号 当前只支持1.0 request_mode 是 String 请求模式。 取值如下： direct_http：HTTP(S)直接访问DRM。 functiongraph_proxy：FunctionGraph代理访问DRM。 http_headers 否 Array of HttpHeader objects 需要添加在drm请求头中的鉴权信息。最多支持配置5个。 仅direct_http请求模式支持配置http_headers。 urn 否 String functiongraph_proxy请求模式需要提供functiongraph的urn。 表21 HttpHeader 参数 是否必选 参数类型 描述 key 是 String 请求头中key字段名 value 是 String 请求头中key对应的value值 表22 PackageRequestArgs 参数 是否必选 参数类型 描述 record 否 Array of RecordRequestArgs objects 录制播放相关配置 timeshift 否 Array of TimeshiftRequestArgs objects 时移播放相关配置 live 否 Array of LiveRequestArgs objects 直播播放相关配置 表23 RecordRequestArgs 参数 是否必选 参数类型 描述 start_time 否 String 开始时间 end_time 否 String 结束时间 format 否 String 格式 unit 否 String 单位 表24 TimeshiftRequestArgs 参数 是否必选 参数类型 描述 back_time 否 String 时移时长字段名 unit 否 String 单位 表25 LiveRequestArgs 参数 是否必选 参数类型 描述 delay 否 String 时延字段 unit 否 String 单位 表26 EncoderSettingsExpand 参数 是否必选 参数类型 描述 audio_descriptions 否 Array of audio_descriptions objects 音频输出配置的描述信息 表27 audio_descriptions 参数 是否必选 参数类型 描述 name 是 String 音频输出配置的名称。仅支持大小写字母，数字，中划线（-），下划线（_）。 同一个频道不同的音频输出配置名称，不允许重复。 audio_selector_name 是 String 音频选择器名称 language_code_control 否 String 语言代码控制。这里的设置不会修改音频实际的语言，只会修改音频对外展示的语言。 包含如下选项： FOLLOW_INPUT：如果所选音频选择器对应的输出音频有语言，则与其保持一致，否则会以这里配置的语言代码和流名称进行兜底。推荐当前选项，为默认值。 USE_CONFIGURED：用户根据实际情况自定义输出音频的语言和流名称。 language_code 否 String 语言代码，输入2或3个小写字母。 stream_name 否 String 流名称

响应示例 状态码： 200 Demo Information { "total" : 1, "channels" : [ { "domain" : "push.testott.hls.com", "app_name" : "ott", "id" : "test", "name" : "testname", "input" : { "input_protocol" : "RTMP_PUSH", "sources" : [ { "url" : "rtmp://push.testott.hls.com/ott/test_1024?request_source=ott&channel_id=test", "bitrate" : 1024, "width" : 100, "height" : 100 } ], "failover_conditions" : { "input_loss_threshold_msec" : 100, "input_preference" : "EQUAL" } }, "record_settings" : { "rollingbuffer_duration" : 86400 }, "endpoints" : [ { "hls_package" : [ { "url" : "pull.testott.hls.com/ott/test/index.m3u8", "stream_selection" : [ { "key" : "sss", "max_bandwidth" : 0, "min_bandwidth" : 0 } ], "segment_duration_seconds" : 4, "playlist_window_seconds" : 3600, "request_args" : { "record" : [ { "start_time" : "begin", "end_time" : "end", "format" : "timestamp", "unit" : "second" } ], "timeshift" : [ { "back_time" : "begin", "unit" : "second" } ], "live" : null }, "hls_version" : "1" } ], "dash_package" : [ { "url" : "pull.testott.hls.com/ott/test/index.mpd", "stream_selection" : [ { "key" : "bitrate=900000-1800000", "max_bandwidth" : 1800000, "min_bandwidth" : 900000 } ], "segment_duration_seconds" : 4, "playlist_window_seconds" : 3600, "request_args" : { "record" : [ { "start_time" : "begin", "end_time" : "end", "format" : "timestamp", "unit" : "second" } ], "timeshift" : [ { "back_time" : "begin", "unit" : "second" } ], "live" : null } } ], "mss_package" : [ { "url" : "pull.testott.hls.com/ott/channel/manifest", "stream_selection" : [ { "key" : "bitrate=900000-1800000", "max_bandwidth" : 1800000, "min_bandwidth" : 900000 } ], "segment_duration_seconds" : 4, "playlist_window_seconds" : 3600, "request_args" : { "record" : [ { "start_time" : "begin", "end_time" : "end", "format" : "timestamp", "unit" : "second" } ], "timeshift" : [ { "back_time" : "begin", "unit" : "second" } ], "live" : null } } ] } ], "state" : "OFF" } ] } 状态码： 400 Error response { "result_code" : "LIVE.103011019", "result_msg" : "The resource to access is not exists", "domain" : "push.testott.hls.com", "app_name" : "ott", "id" : "agbc" }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 total Integer 总频道数 channels Array of CreateOttChannelInfoReq objects 频道信息 表5 CreateOttChannelInfoReq 参数 参数类型 描述 domain String 频道推流域名 app_name String 组名或应用名 id String 频道ID。频道唯一标识，为必填项。 name String 频道名。可选配置 state String 频道状态 ON：频道下发成功后，自动启动拉流、转码、录制等功能 OFF：仅保存频道信息，不启动频道 input InputStreamInfo object 频道入流信息 encoder_settings Array of encoder_settings objects 转码模板配置 record_settings record_settings object 回看录制的配置信息。 endpoints Array of EndpointItem objects 频道出流信息 encoder_settings_expand EncoderSettingsExpand object 音频输出配置 表6 InputStreamInfo 参数 参数类型 描述 input_protocol String 频道入流协议 FLV_PULL RTMP_PUSH HLS_PULL SRT_PULL SRT_PUSH sources Array of SourcesInfo objects 频道主源流信息。入流协议为RTMP_PUSH和SRT_PUSH时，非必填项。其他情况下，均为必填项。 secondary_sources Array of SecondarySourcesInfo objects 备入流数组，非必填项。如果有备入流，则主备入流必须保证路数、codec和分辨率均一致。入流协议为RTMP_PUSH时，无需填写。 failover_conditions FailoverConditions object 非必填，频道供应商提供的主备音视频流URL切换的配置。 max_bandwidth_limit Integer 当入流协议为HLS_PULL时，需要配置的最大带宽。 用户提供的拉流URL中，针对不同码率的音视频，均会携带带宽参数“BANDWIDTH”。 如果这里配置最大带宽，媒体直播服务从URL拉流时，会选择小于最大带宽且码率最大的音视频流，推流到源站。 如果这里未配置最大带宽，媒体直播服务从URL拉流时，会默认选择“BANDWIDTH”最高的音视频流，推流到源站。 ip_port_mode Boolean 当推流协议为SRT_PUSH时，如果配置了直推源站，编码器不支持输入streamid，需要打开设置为true ip_whitelist String SRT_PUSH类型时，客户push ip白名单 scte35_source String 广告的scte35信号源。 仅HLS_PULL类型的频道支持此配置，且目前仅支持SEGMENTS。 ad_triggers Array of strings 广告触发器配置。 包含如下取值： Splice insert：拼接插入 Provider advertisement：提供商广告 Distributor advertisement：分销商广告 Provider placement opportunity：提供商置放机会 Distributor placement opportunity：分销商置放机会 audio_selectors Array of InputAudioSelector objects 设置音频选择器，最多设置8个音频选择器 表7 SourcesInfo 参数 参数类型 描述 url String 频道源流URL，用于外部拉流 bitrate Integer 码率。无需直播转码时，此参数为必填项 单位：bps。取值范围：(0,104,857,600]（100Mbps） width Integer 分辨率对应宽的值，非必填项 取值范围：0 - 4096（4K） height Integer 分辨率对应高的值，非必填项 取值范围：0 - 2160（4K） enable_snapshot Boolean 描述是否使用该流做截图 bitrate_for3u8 Boolean 是否使用bitrate来固定码率。默认值：false passphrase String 协议为SRT_PUSH时的加密信息 backup_urls Array of strings 备入流地址列表 stream_id String 频道为SRT_PULL类型时，拉流地址的Stream ID。 latency Integer 频道为SRT_PULL类型时的拉流时延。 表8 SecondarySourcesInfo 参数 参数类型 描述 url String 频道源流URL，用于外部拉流 bitrate Integer 码率。无需直播转码时，此参数为必填项 单位：bps。取值范围：(0,104,857,600]（100Mbps） width Integer 分辨率对应宽的值，非必填项 取值范围：0 - 4096（4K） height Integer 分辨率对应高的值，非必填项 取值范围：0 - 2160（4K） bitrate_for3u8 Boolean 是否使用bitrate来固定码率。默认值：false passphrase String 协议为SRT_PUSH时的加密信息 backup_urls Array of strings 备入流地址列表 stream_id String 频道为SRT_PULL类型时，拉流地址的Stream ID。 latency Integer 频道为SRT_PULL类型时的拉流时延。 表9 FailoverConditions 参数 参数类型 描述 input_loss_threshold_msec Integer 入流停止的时长阈值。到达此阈值后，自动触发主备切换。 单位：毫秒，取值范围：0 - 3600000。 非必填，默认填2000ms。 input_preference String 以主入流URL为第一优先级（PRIMARY）或主备URL平等切换（EQUAL）。 如果是平等切换时，使用的是备URL，不会自动切换至主URL。 非必填，默认值为EQUAL。 表10 InputAudioSelector 参数 参数类型 描述 name String 音频选择器的名称。仅支持大小写字母、数字、中划线和下划线。 同一个频道中每个选择器的名称需要唯一。 selector_settings AudioSelectorSettings object 设置音频选择器 表11 AudioSelectorSettings 参数 参数类型 描述 audio_language_selection AudioSelectorLangSelection object 设置语言选择器 audio_pid_selection AudioSelectorPidSelection object 设置PID选择器 audio_hls_selection AudioSelectorHlsSelection object 设置Hls选择器 表12 AudioSelectorLangSelection 参数 参数类型 描述 language_code String 语言简称，输入2或3个小写字母的语言代码。 language_selection_policy String 语言输出策略。 取值如下： LOOSE：宽松匹配，示例“eng”会优先匹配源流中语言为English的音轨，如果匹配不到，则选择PID最小的音轨。 STRICT：严格匹配，示例“eng”会严格匹配源流中语言为English的音轨，如果匹配不到，媒体直播服务会自动补齐一个静音分片，当终端使用此音频选择器播放视频时，会静音播放。 表13 AudioSelectorPidSelection 参数 参数类型 描述 pid Integer 设置PID的值 表14 AudioSelectorHlsSelection 参数 参数类型 描述 name String hls音频选择器名 group_id String hls音频选择器gid 表15 encoder_settings 参数 参数类型 描述 template_id String 转码模板ID 表16 record_settings 参数 参数类型 描述 rollingbuffer_duration Integer 最大回看录制时长。在此时间段内会连续不断的录制，为必选项 单位：秒。取值为“0”时，表示不支持录制；最大支持录制14天 表17 EndpointItem 参数 参数类型 描述 hls_package Array of HlsPackageItem objects HLS打包信息 dash_package Array of DashPackageItem objects DASH打包信息 mss_package Array of MssPackageItem objects MSS打包信息 表18 HlsPackageItem 参数 参数类型 描述 url String 客户自定义的拉流地址，包括方法、域名、路径 stream_selection Array of StreamSelectionItem objects 从全量流中过滤出一个码率在[min, max]区间的流。如果不需要码率过滤可不选。 hls_version String HLS版本号 segment_duration_seconds Integer 频道输出分片的时长，为必选项 单位：秒。取值范围：1-10 说明： 修改分片时长会影响已录制内容的时移和回看服务，请谨慎修改！ playlist_window_seconds Integer 频道直播返回分片的窗口长度，为频道输出分片的时长乘以数量后得到的值。实际返回的分片数不小于3个。 单位：秒。取值范围：0 - 86400（24小时转化成秒后的取值） encryption Encryption object 加密信息 ads Object 广告配置 ext_args Object 其他额外参数 request_args PackageRequestArgs object 播放相关配置 ad_marker Array of strings 广告标识。 HLS取值：["ENHANCED_SCTE35"]。 表19 DashPackageItem 参数 参数类型 描述 url String 客户自定义的拉流地址，包括方法、域名、路径 stream_selection Array of StreamSelectionItem objects 从全量流中过滤出一个码率在[min, max]区间的流。如果不需要码率过滤可不选。 segment_duration_seconds Integer 频道输出分片的时长，为必选项 单位：秒。取值范围：1-10 说明： 修改分片时长会影响已录制内容的时移和回看服务，请谨慎修改！ playlist_window_seconds Integer 频道直播返回分片的窗口长度，为频道输出分片的时长乘以数量后得到的值。实际返回的分片数不小于3个。 单位：秒。取值范围：0 - 86400（24小时转化成秒后的取值） encryption Encryption object 加密信息 ads Object 广告配置 ext_args Object 其他额外参数 request_args PackageRequestArgs object 播放相关配置 ad_marker String 广告标识。 DASH取值："xml+bin"。 表20 MssPackageItem 参数 参数类型 描述 url String 客户自定义的拉流地址，包括方法、域名、路径 stream_selection Array of StreamSelectionItem objects 从全量流中过滤出一个码率在[min, max]区间的流。如果不需要码率过滤可不选。 segment_duration_seconds Integer 频道输出分片的时长，为必选项 单位：秒。取值范围：1-10 说明： 修改分片时长会影响已录制内容的时移和回看服务，请谨慎修改！ playlist_window_seconds Integer 频道直播返回分片的窗口长度，为频道输出分片的时长乘以数量后得到的值。实际返回的分片数不小于3个。 单位：秒。取值范围：0 - 86400（24小时转化成秒后的取值） encryption Encryption object 加密信息 ext_args Object 其他额外参数 delay_segment Integer 延播时长，单位秒 request_args PackageRequestArgs object 播放相关配置 表21 StreamSelectionItem 参数 参数类型 描述 key String 拉流URL中用于码率过滤的参数 max_bandwidth Integer 最大码率，单位：bps 取值范围：0 - 104,857,600（100Mbps） min_bandwidth Integer 最小码率，单位：bps 取值范围：0 - 104,857,600（100Mbps） 表22 Encryption 参数 参数类型 描述 key_rotation_interval_seconds Integer 密钥缓存时间。如果密钥不变，默认缓存七天。 请注意：目前为保留字段，不支持配置。 encryption_method String 加密方式。 请注意：目前为保留字段，不支持配置。 level String 取值如下： content：一个频道对应一个密钥 profile：一个码率对应一个密钥 默认值：content resource_id String 客户生成的DRM内容ID system_ids Array of strings system_id枚举值。 取值如下： HLS：FairPlay DASH：Widevine、PlayReady MSS：PlayReady url String 获取密钥的DRM地址 speke_version String drm speke 版本号 当前只支持1.0 request_mode String 请求模式。 取值如下： direct_http：HTTP(S)直接访问DRM。 functiongraph_proxy：FunctionGraph代理访问DRM。 http_headers Array of HttpHeader objects 需要添加在drm请求头中的鉴权信息。最多支持配置5个。 仅direct_http请求模式支持配置http_headers。 urn String functiongraph_proxy请求模式需要提供functiongraph的urn。 表23 HttpHeader 参数 参数类型 描述 key String 请求头中key字段名 value String 请求头中key对应的value值 表24 PackageRequestArgs 参数 参数类型 描述 record Array of RecordRequestArgs objects 录制播放相关配置 timeshift Array of TimeshiftRequestArgs objects 时移播放相关配置 live Array of LiveRequestArgs objects 直播播放相关配置 表25 RecordRequestArgs 参数 参数类型 描述 start_time String 开始时间 end_time String 结束时间 format String 格式 unit String 单位 表26 TimeshiftRequestArgs 参数 参数类型 描述 back_time String 时移时长字段名 unit String 单位 表27 LiveRequestArgs 参数 参数类型 描述 delay String 时延字段 unit String 单位 表28 EncoderSettingsExpand 参数 参数类型 描述 audio_descriptions Array of audio_descriptions objects 音频输出配置的描述信息 表29 audio_descriptions 参数 参数类型 描述 name String 音频输出配置的名称。仅支持大小写字母，数字，中划线（-），下划线（_）。 同一个频道不同的音频输出配置名称，不允许重复。 audio_selector_name String 音频选择器名称 language_code_control String 语言代码控制。这里的设置不会修改音频实际的语言，只会修改音频对外展示的语言。 包含如下选项： FOLLOW_INPUT：如果所选音频选择器对应的输出音频有语言，则与其保持一致，否则会以这里配置的语言代码和流名称进行兜底。推荐当前选项，为默认值。 USE_CONFIGURED：用户根据实际情况自定义输出音频的语言和流名称。 language_code String 语言代码，输入2或3个小写字母。 stream_name String 流名称 状态码： 400 表30 响应Body参数 参数 参数类型 描述 result_code String 错误码 result_msg String 错误描述 domain String 推流域名 app_name String 组名或应用名，为必填项 id String 频道ID。频道唯一标识，为必填项

请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token，使用Token鉴权方式时必选。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Access-Control-Allow-Internal 否 String 服务鉴权Token，服务开启鉴权，必须携带Access-Control-Allow-Internal访问服务。 Access-Control-Allow-External 否 String 服务鉴权Token，服务开启鉴权，必须携带Access-Control-Allow-External访问服务。

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

配置说明 表1 配置说明 参数名 是否必须 功能 devspore.auth.exclude-paths false 不需要认证的路径，多个规则用分号（;）分隔，优先级大于devspore.auth.auth-patterns。 devspore.auth.auth-patterns false 需要认证的路径，多个规则用分号（;）分隔。 devspore.auth.in-header false token是否在header中，默认true。 devspore.auth.token-name false token在header中的参数名，inHeader设置为true时生效，默认“X-Auth-Token”。

认证配置 在配置文件中加入oauth2认证相关配置和devspore相关配置，如下： devspore: auth: exclude-paths: GET:/test # 不需要认证的路径，多个规则用;分隔 auth-patterns: /v1/** # 需要认证的路径，多个规则用;分隔 in-header: true # token是否在header中，默认true token-name: X-Auth-Token # token在header中的参数名，inHeader设置为true时生效，默认X-Auth-Token

实现UserStore接口 import com.huawei.devspore.plugin.spi.authentication.UserInfo; import com.huawei.devspore.plugin.spi.authentication.UserStore; import org.springframework.stereotype.Component; @Component public class CustomUserStore implements UserStore { @Override public void setUserInfo(UserInfo userInfo) { // 自定义存储用户信息 ...... } @Override public UserInfo getUserInfo() { UserInfo userInfo = new UserInfo(); // 自定义用户信息获取 ...... return userInfo; } }

实现TokenParser接口 import com.huawei.devspore.plugin.spi.authentication.UserInfo; import com.huaweicloud.devspore.auth.commons.spi.TokenParser; import jakarta.servlet.http.HttpServletRequest; import jakarta.servlet.http.HttpServletResponse; import org.springframework.stereotype.Component; @Component public class CustomTokenParser implements TokenParser { /** * 若token定义在header中，可使用该接口，token获取根据配置由devspore-auth获取 * * @param token * @param response * @return UserInfo */ @Override public UserInfo parserToken(String token, HttpServletResponse response) { // 自定义token解析 ...... // 判断token是否过期 ...... UserInfo userInfo = new UserInfo(); // 根据解析后的token信息填充UserInfo对象 ...... return userInfo; } /** * 若token未定义在header中，使用该接口 * * @param request * @param response * @return UserInfo */ @Override public UserInfo parserToken(HttpServletRequest request, HttpServletResponse response) { // 从httpServletRequest获取token ...... // 自定义token解析 ...... // 判断token是否过期 ...... UserInfo userInfo = new UserInfo(); // 根据解析后的token信息填充UserInfo对象 ...... return userInfo; } }

使用说明 AstroPro为每个项目预置了项目管理员、架构师和开发者三种类型的角色。 项目管理员 可以增删改査项目下的所有资源。 可以为项目下的所有角色分配用户（仅限于同账号下的用户，如图1中的IAM用户1、IAM用户2）。 图1 华为账号与IAM用户 架构师 可以新建服务。 可以删除本人创建的服务，不能删除其他人创建的服务。 可以对项目下的所有服务进行编辑。 开发者 可以查看项目下的所有资源。 可以重新编译有权限项目下的服务并下载代码。

前提条件 只有工作空间管理员或项目管理员，才能为其他用户添加项目级角色。不同的是具备工作空间管理员权限的用户，可以为用户添加工作空间下所有项目的权限。而项目管理员只能为用户添加其所在项目的角色权限。 待添加的IAM用户已创建（如IAM用户2）。如何创建IAM用户，请参见创建IAM用户。 IAM用户（如IAM用户1）必须已添加到用户组admin或group。加入用户组后，用户才会具备用户组的权限。若不加入用户组，登录AstroPro服务时，会提示您没有当前服务的访问权限。 admin：缺省用户组，具有所有云服务资源的操作权限。将用户加入该用户组后，用户可以操作并使用所有云服务资源。如果您创建的IAM用户是管理员，才需要将其加入默认用户组“admin”中。 group：自定义的用户组，如何创建一个用户组，请参见创建用户组并授权。自定义用户组时，必须为用户组添加“Astro Pro FullAccess”和“Astro Pro InstanceManagement”系统策略，如图3。 图2 通过用户组为用户授权 图3 自定义用户组必须具备权限

功能介绍 Abstract BO是一个抽象对象，不能单独存在，没有数据库表，需要和业务对象建立继承的关系。建立继承关系后，业务对象会继承抽象对象中的字段。例如，抽象对象Abstract和业务对象Role存在继承关系，在抽象对象Abstract中，新建一个name字段，该字段会被Role自动继承。 图1 和业务对象Role建立继承关系 图2 在Abstract BO中新建一个name字段 图3 Role中继承name字段

属性说明 在业务设计页面，从“business”中，拖拽“Abstract BO”对象至画布空白区域。选中对象，在右侧页面设置对象属性，如图4所示。 图4 Abstract BO 对象名称：设置对象的名称，必须使用大驼峰格式，不允许存在连续的大写字母。 中文名：设置对象的中文名称。 BO属性操作：单击“编辑字段”，可以为对象添加所需的字段。 软删除策略：开启软删除策略后，数据删除时执行逻辑删除，数据仍然保留在数据库中。关闭软删除策略后，数据删除为物理删除，即直接从数据库中删除，不可恢复。 购买AstroPro企业版实例时，才会显示“软删除策略”配置项。 恢复软删除：当开启“软删除策略”时可配置。开启恢复软删除，则支持将软删除的数据恢复。 操作：对新建的对象可执行哪些操作，如新增、更新、删除、查询、批量新增、批量更新、批量查询、批量删除和自定义查询。默认值为新增、更新、删除、查询和批量查询。 对象版本化：通过版本号的机制实现的乐观锁功能。开启此功能时，会在表中自动添加一个devspore_verion的字段来记录版本。在更新操作时会检查当前版本号和DB中的版本号是否一致，一致则更新数据并增加版本号，如果不同则说明数据已被其他事务修改，更新失败。 购买AstroPro企业版实例时，才会显示“对象版本化”配置项。 对象描述：对象的描述信息。

操作步骤 在业务设计页面，单击“自定义DTO”。 图1 自定义DTO 单击“新增”，添加一个自定义DTO。 图2 自定义一个Dto1 在自定义API的参数或返回体中，使用自定义DTO。 从“business”中，拖拽“BO”对象至画布空白区域。 选中BO对象，在对象属性中，单击“自定义API”。 图3 自定义API 单击“新增”，添加一个自定义API。 图4 自定义一个API 在请求对象或返回对象的参数中，使用自定义DTO。 图5 在自定义API中使用自定义DTO

属性说明 在业务设计页面，从“business”中，拖拽“Value Object”对象至画布空白区域。选中对象，在右侧页面设置对象属性，如图4所示。 图4 Value Object 对象名称：设置对象的名称，必须使用大驼峰格式，不允许存在连续的大写字母。 中文名：设置对象的中文名称。 BO属性操作：单击“编辑字段”，可以为对象添加所需的字段。 软删除策略：开启软删除策略后，数据删除时执行逻辑删除，数据仍然保留在数据库中。关闭软删除策略后，数据删除为物理删除，即直接从数据库中删除，不可恢复。 购买AstroPro企业版实例时，才会显示“软删除策略”这个配置项。 恢复软删除：当开启“软删除策略”时可配置。开启恢复软删除，则支持将软删除的数据恢复。 支持BO多租：BO是否支持多租。开启BO多租时，请确保“多租模型”已开启。 购买AstroPro专业版及企业版实例时，才会显示“支持BO多租”配置项。 图5 开通多租模型 不允许修改：对象是否支持修改。 操作：对新建的对象可执行哪些操作，如新增、更新、删除、查询、批量新增、批量更新、批量查询、批量删除和自定义查询。默认值为新增、更新、删除、查询和批量查询。 对象版本化：通过版本号的机制实现的乐观锁功能。开启此功能时，会在表中自动添加一个devspore_verion的字段来记录版本。在更新操作时会检查当前版本号和DB中的版本号是否一致，一致则更新数据并增加版本号，如果不同则说明数据已被其他事务修改，更新失败。 购买AstroPro企业版实例时，才会显示“对象版本化”配置项。 对象描述：对象的描述信息。

示例 创建服务时“Package”设置为“com.astropro”。在业务设计中添加自定义API，动作名称为action1，请求方式为GET，返回对象为200，代码生成层勾选接口层和应用层，则代码生成时，将在接口层和应用层生成对应API的代码，如图6所示。 图4 设置打包路径 图5 添加自定义API 图6 查看生成代码 表2 不同目录结构下实际影响代码路径说明 目录结构 接口层 应用层 数据访问层 DDD {package}.api.xxx {package}.app.xxx {package}.infrastructure.repository.base.xxx Single {package}.api.xxx {package}.service.xxx {package}.repository.base.xxx base/service {package}.api.xxx {package}.service.xxx {package}.repository.base.xxx package为创建服务时定义的打包路径。

添加自定义API 在业务设计页面，选中某个业务对象。 单击BO属性操作中的“自定义API”，进入编辑自定义API页面。 单击“新增”，按需添加所需的API。 实例级别：定义API实例的级别，如类型、实例。 动作名称：设置API的动作名称。 请求方法：HTTP请求方法（也称为操作或动作），用于告诉服务您正在请求什么类型的操作。 get：请求服务器返回指定资源。 put：请求服务器更新指定资源。 post：请求服务器新增资源或执行特殊操作。 delete：请求服务器删除指定资源。 请求对象：单击“添加请求对象”，可添加请求对象，即API请求的输入参数。 返回对象：请求发送后，您会收到的响应，如状态码。 路径：单击“输入path”，添加API的路径，格式为变量放到“{}”中，单词用“_”连接，非变量单词用“-”连接。例如：/meta-bo1s/{meta_bo1_id}/test-action。 当您没有自定义API路径，且“实例级别”选择“实例”时，生成的API路径上会拼接一个{MetaBo}_id的路径，同时方法上会多生成一个当前MetaBo主键的参数，如图2所示。 图2 API路径 描述：输入自定义API的描述信息。 设置代码生成层，参数设置与代码生成关系请参考表1。 表1 设置代码生成层组合说明 接口层 应用层 数据访问层 代码生成 x √ x 仅在应用层生成代码。 x x √ 仅在数据访问层生成代码。 √ √ x 在接口层和应用层生成代码。 x √ √ 在应用层和数据访问层生成代码。 √ √ √ 在接口层、应用层和数据访问层皆生成代码。 图3 设置代码生成层 设置完成后，单击“保存”。

前提条件 只有具备工作空间管理员权限的用户，才能为其他用户添加工作空间级角色。 待添加的IAM用户已创建（如IAM用户1）。如何创建IAM用户，请参见创建IAM用户。 IAM用户（如IAM用户1）必须已添加到用户组admin或group。加入用户组后，用户才会具备用户组的权限。若不加入用户组，登录AstroPro服务时，会提示您没有当前服务的访问权限。 admin：缺省用户组，具有所有云服务资源的操作权限。将用户加入该用户组后，用户可以操作并使用所有云服务资源。如果您创建的IAM用户是管理员，才需要将其加入默认用户组“admin”中。 group：自定义的用户组，如何创建一个用户组，请参见创建用户组并授权。自定义用户组时，必须为用户组添加“Astro Pro FullAccess”和“Astro Pro InstanceManagement”系统策略，如图2。 图1 通过用户组为用户授权 图2 自定义用户组必须具备权限

操作步骤 在业务设计页面，单击“脱敏规则”。 图1 选择脱敏规则 单击“新增”，添加一个脱敏规则。 例如，将移动电话的第2位到第5位数字进行脱敏处理。 图2 自定义脱敏规则 在对象的字段中，使用脱敏规则。 从“business”中，拖拽“BO”对象至画布空白区域。 选中BO对象，在对象属性中，单击“编辑字段”。 单击“新增”，添加一个phone字段，并将脱敏规则设置为2中定义的内容。 设置后，返回的值将进行脱敏处理，如1****123456。 图3 引用脱敏规则