一．功能简介

互动直播业务中，直播内容由主播实时推送，若主播推送的直播内容中包含“涉黄涉恐”等国家明令禁止的非法内容，一经播出，便会给在线直播平台带来极大负面影响。因此，直播客户需要对直播内容合法性进行鉴定。

先前常用的鉴定方法是拉取一路直播流，对直播内容进行监测，此方法最大的问题是客户办公区域带宽一般难以承载同时数百路直播流，且对于直播流的合法性只能依赖于人工鉴别，难以实现自动化鉴别。

在此情况下，网宿提供直播实时截图技术，供客户以图片形式获取直播内容，使客户可通过图片来进行视频监控，若同时配合某些图片鉴黄类应用，则可实现自动化审核，大大降低人工成本的同时，极好的解决了办公区域网络环境无法同时监控上百个视频流的问题。

另一方面，客户需要也可通过截图功能获取当前直播的内容当成视频封面。

二．使用说明

为降低人工鉴黄的成本压力和效率，更好的支持图片鉴黄类应用，网宿提供直播定时截图功能。由主播发起直播推流后，网宿根据与客户约定截图频率对当前直播流进行截图，截取的图片存储在 WCS平台上，并回调客户接口通知客户截图信息。

1、输出图片格式：支持jpg、png等。
2、支持设置图片的宽高：单位：像素（px），宽值域：1-9020，高值域：1-1080。
3、支持图片旋转：默认不旋转，可配置90、180、270度旋转。
4、支持图片拼接：支持多个截图文件拼图上传。
5、截图频率可配置，建议30S一张。

截图开始、截图结束回调
实时截图支持回调客户接口通知客户截图信息，并可对回调通知进行合并，避免频繁通知消耗资源。回调不宜频繁，建议60s回调一次或累积100张图回调一次。

截图开始通知：
通知地址示例：http://abc.com?message_type=ws_record_start

注：通知地址响应200即表示通知成功。

通知内容：
通知地址将收到一个经过URL安全的Base64编码的Json信息，客户获取通知内容后需要进行解析。解析后内容格式如下：

{
    "persistentId": "<persistentId>",
    "streamname": "<streamname>",
    "ops": "<Record ops>",
    "bucket": "<bucket>",
"batch_notify_id": "<batch_notify_id>"
}

截图结束通知：
通知地址示例：http://abc.com?message_type=ws_record_finish

注：通知地址响应200即表示通知成功。

通知内容
通知地址将收到一个经过URL安全的Base64编码的Json信息，客户获取通知内容后需要进行解析。解析后内容格式如下：

{
    "items": [
        {
            "persistentId": "< persistentId >",
            "streamname": "<streamname>",
            "ops": "<ops>", 
            "bucket": "<bucket>",
            "code": "<code>",
            "desc": "<desc>",
            "error": "<error>",
            "keys": [
                "key1",
                "key2",
                "key3"
            ],
            "urls": [
                "url1",
                "url2"
            ]
        },
        {
            "persistentId": "< persistentId >",
            "streamname": "<streamname>",
            "ops": "<ops>",
            "bucket": "<bucket>",
            "code": "<code>",
            "desc": "<desc>",
            "error": "<error>",
            "keys": [
                "key1",
                "key2",
                "key3"
            ],
            "urls": [
                "url1",
                "url2"
            ]
        }
    ],
    "batch_notify_id": "<batchnotifyid>"
}

三．应用场景

1、互动直播客户，实时获取最新的直播流信息用于内容审核
2、互动直播客户，需要将直播流生成图片当作视频封面。

四．注意事项

客户若需要开通实时截图功能，需要提供给网宿以下信息：
1、提供截取图片的格式，支持jpg、png格式
2、与网宿约定实时截图频率。
3、开通网宿WCS存储服务，并提供存储空间。
4、提供给网宿截图回调地址、回调合并通知频率，并约定回调失败处理机制等。