概述

当前Hub级别或者单流级别都可以开启/关闭鉴黄功能。开启后，系统会根据用户设置的时间间隔对直播流进行截帧鉴黄，并根据用户设定的阈值进行回调通知。

Hub级别鉴黄功能

开启后，Hub下的所有流都会开始鉴黄。

单流级别鉴黄功能

开启后，用户可以针对某些主播的流开启鉴黄功能。
关闭后，即使Hub的鉴黄功能是开启状态，该流也不会鉴黄。

如何开启

Hub开启

前往 https://portal.qiniu.com/hub/<客户的Hub>/configuration 配置(如下图)

• 全局开启/关闭：开启/关闭Hub级别的功能
• 截帧间隔： 每个流隔多久(秒)进行截帧并鉴黄
• 通知阈值： 鉴黄结果的rate大于等于该值时，会把这次鉴定结果发送给客户
• 回调通知URL：用户接受回调通知的业务服务器URL
• 疑似帧通知：开启后，小于通知阈值的疑似帧也会发起回调通知

单流开启

启用单流鉴黄首先需要确保上面的Hub配置除了鉴黄开关（应当是关闭状态），其余值都配置正确。 单流级别开启/关闭需要通过API接口。

a.创建流时开启/关闭

创建流时带上布尔类型的”nropEnable”字段：

• true，开启
• false，关闭
• 没有该字段，沿用Hub的状态

POST /v2/hubs/<Hub>/streams
Host: pili.qiniuapi.com
Authorization: <QiniuToken>
Content-Type: application/json

{
    "key": "<StreamKey>",
    "nropEnable": "<NropEnable>" //选填
}

b.现有流开启/关闭

POST /v2/hubs/<Hub>/streams/<EncodedStreamKey>/nrop
Host: pili.qiniuapi.com
Authorization: <QiniuToken>
Content-Type: application/json

{
    "nropEnable": <NropEnable> //布尔类型
}

回调通知内容

根据用户设定的阈值，发现黄色内容后通知给客户的协议

POST <NotifyURL>
Content-type: application/json
{
    "hub": "<Hub>",
    "streamId": "<Stream ID>",// 流ID，形如z1.test.stream1
    "stream": "<Stream>",// 流名
    "rate": <Rate>,// 介于0-1间的浮点数，表示该图像被识别为色情的概率值，概率越高、机器越肯定
    "time": <Timestamp>,
    "ts": "<TS>",// 对应的ts文件名
    "label": "<porn|sexy|normal>",  标签分别 <涉黄|性感|正常>
    "review": <Bool> // true表示需要人工审核，false为不需要
}

服务价格

使用量预估

方法一

根据主播时长预估：
使用量=直播总时间(秒)/截帧间隔(秒)

例如，某月平均每日直播时长为2000小时，截帧间隔20秒，那么

平均每日使用量=2000x60x60/20=360000张；月度使用量=360000x30=1080万张

产生费用=0.18元/百张x300万张+0.16元/百张x780万张=17880元

方法二

根据上行流量预估(按每个流1M码率)：
使用量=上行流量(GB) x 8000/截帧间隔(秒)

例如，某月上行流量为20000GB，截帧间隔20秒，那么

使用量=20000x8000/20=800万张

产生费用=0.18元/百张x300万张+0.16元/百张x500万张=13400元

七牛云直播客户可在开发者中心查看上行流量数据，计算结果为经验值。