API 文档

直播截图和鉴黄

最近更新时间:2021-06-30 15:36:34

云直播提供截图鉴黄功能,支持通过控制台配置的截图鉴黄模板,推流域名关联模板后,在推流过程中截取直播画面,将直播截图或鉴黄数据存储至腾讯云对象存储中。若该推流域名已关联回调配置,即可在直播过程中触发回调事件后,腾讯云主动发送请求到客户服务器,客户服务器负责应答请求。验证通过后即可获取含鉴黄回调信息的 JSON 数据包。
本文将向您介绍如何通过控制台创建、绑定、解绑、修改及删除截图鉴黄模板。

其中,创建截图鉴黄模板有以下两种方式:

注意事项

  • 截图功能可单独开启使用,但鉴黄功能需开启截图后才能开启,不可单独使用。
  • 截图与鉴黄为收费功能,启用后,截图功能按每千张¥0.1元收费;鉴黄功能按每千张¥1.3元收费。详情请参见 智能鉴黄
  • 截图与鉴黄图片存储至您的对象存储 COS 中,将产生 COS 存储费用,详情请查看 COS 产品计费定价
  • 开通截图功能需要先在 COS bucket 中授权云直播服务的数据写入权限,详情可参见 COS bucket 授权给直播实现截图存储
  • 模板创建成功后,可与推流域名进行关联,相关文档可参见 截图鉴黄配置。模板关联成功后约5分钟 - 10分钟生效。
  • 控制台的截图鉴黄模板管理为域名维度,暂时无法取消关联接口创建的规则,如果是通过截图鉴黄相关接口关联指定流的,则需要通过调用 删除截图规则 解除关联。
  • 模板绑定、修改和解绑均只影响更新后的直播流,已经在直播中的流不会受影响;直播中的流需要断流重推才会使用新的规则。

使用前提

创建截图鉴黄模板

  1. 登录云直播控制台,【功能配置】>【直播截图&鉴黄】
  2. 单击【+】,填写配置项,并单击【保存】即可。
    配置项说明
    模板名称 截图鉴黄模板名称,仅支持填写中文、英文、数字、_、-,不超过30个字符。
    模板描述 截图鉴黄模板介绍描述,仅支持填写中文、英文、数字、_、-,不超过100个字符。
    截图间隔 推流过程中自动截图间隔时间,默认为2秒,取值范围:2秒 - 300秒。
    启用智能鉴黄 可选择是否开启鉴黄功能,启用智能鉴黄后,需配置回调才可收到鉴黄结果。
    存储账号 可选择『当前账号』或『其他账号』。
    AppId 仅在选择存储账号类型为『其他账号』的情况下需要填写,APPID 信息可前往其他账号下的 【账号信息】获取。
    Bucket 选择您已在【对象存储】中创建并完成授权的 COS bucket。
    Region 上述 Bucket 所属地域信息,不可修改。
    文件夹 单击选择框,进入选择 COS 文件夹。默认为:{Year}-{Month}-{Day}/
    说明:COS 文件夹名称只允许[a-z,A-Z,0-9]和符号-,!,_,.,*以及占位符。
    文件名 截图文件名格式,可自定义组合参数拼装而成。默认为:{StreamID}-screenshot-{Hour}-{Minute}-{Second}-{Width}x{Height}{Ext},其中:
    • {AppName} :推流 AppName
    • {PushDomain} :推流域名
    • {StreamID} :流 ID
    • {Year} :截图时间(年)
    • {Month} :截图时间(月)
    • {Day} :截图时间(日)
    • {Hour} :截图时间(时)
    • {Minute} :截图时间(分)
    • {Second} :截图时间(秒)
    • {Width} :图片宽
    • {Height} :图片高
    • {Ext} :扩展名(.jpg)
    说明:只允许[a-z,A-Z,0-9]和符号-,!,_,.,*以及占位符。
    举例:填写文件名格式为: {Year}-{Month}-{Day}- {Hour}-{Ext},则在2020年01月01日14:00:00 自动截取直播画面,存储到 COS 中的文件名为:2020010114.jpg

关联域名

  1. 登录云直播控制台,进入【功能配置】>【直播截图&鉴黄】
  2. 通过以下方式进入域名绑定窗口:
    • 直接关联域名:单击左上方的【绑定域名】。
    • 新截图&鉴黄模板创建成功后关联域名:截图&鉴黄模板创建 成功后,单击提醒框中的【去绑定域名】。
  3. 在域名绑定窗口中,选择您需绑定的截图&鉴黄模板推流域名,单击【确定】即可绑定成功。
    说明:

    支持通过单击【添加】为当前模板绑定多个推流域名。

解除绑定

  1. 登录云直播控制台,进入【功能配置】>【直播截图&鉴黄】
  2. 选择已关联域名的直播截图&鉴黄模板,单击【解绑】。
  3. 确认是否解绑当前关联域名,单击【确定】即可解绑。

修改模板

  1. 进入【功能配置】>【直播截图&鉴黄】
  2. 选择您已创建成功的截图鉴黄模板,并单击右侧的【编辑】,即可进入修改模板信息。
  3. 单击【保存】即可。

删除模板

注意:

若模板已被关联,需要先 解除绑定,才可以进行删除操作。

  1. 进入【功能配置】>【直播截图&鉴黄】
  2. 选择您已创建成功的截图鉴黄模板,单击上方的删除按钮。
  3. 确认是否删除当前截图鉴黄配置模板,单击【确定】即可成功删除。

相关操作

域名维度绑定解绑截图鉴黄模板的具体操作及相关说明,请参见 截图鉴黄配置

目录