直播云

  • 直播云 > 快速入门 > 直播鉴黄接入文档

    直播鉴黄接入文档

    最近更新时间: 2021-01-28 15:07:48

    概述

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

    Hub级别鉴黄功能

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

    单流级别鉴黄功能

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

    如何开启

    Hub开启

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

    • 全局开启/关闭:开启/关闭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为不需要
    }
    

    服务价格

    总调用量P(单位:万张) 调用单价(单位:元/百张)
    P < = 300 0.18
    300 < P <=1500 0.16
    1500 < P <= 3000 0.15
    P > 3000 0.13

    使用量预估

    方法一

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

    例如,某月平均每日直播时长为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元

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

    以上内容是否对您有帮助?
  • Qvm free helper
    Close