目录目录目录推流接入推流接入视频云鉴权直播推拉流服务视频云鉴权简单鉴权外部鉴权直播推拉流服务 RTMP 推流 RTMP 直播拉流 HLS 直播拉流 HTTP+FLV 直播拉流旧版开播断流回调开播回调关播回调新版开关播回调开播回调关播回调延时直播延时直播产品介绍应用场景产品优

Size: px

Start display at page:

Download "目录目录目录推流接入推流接入视频云鉴权直播推拉流服务视频云鉴权简单鉴权外部鉴权直播推拉流服务 RTMP 推流 RTMP 直播拉流 HLS 直播拉流 HTTP+FLV 直播拉流旧版开播断流回调开播回调关播回调新版开关播回调开播回调关播回调延时直播延时直播产品介绍应用场景产品优"

牧誉郜
4 years ago
Views:

1 目录目录目录推流接入推流接入视频云鉴权直播推拉流服务视频云鉴权简单鉴权外部鉴权直播推拉流服务 RTMP 推流 RTMP 直播拉流 HLS 直播拉流 HTTP+FLV 直播拉流旧版开播断流回调开播回调关播回调新版开关播回调开播回调关播回调延时直播延时直播产品介绍应用场景产品优势充分延时时长源流供监控延播流供观看秒级禁播开通说明直播录像 HLS 录像 MP4 录像 FLV 录像录像回调 HLS 录像方式 1( 默认 ) 时长在 10 小时内 m3u 文件时长大于 10h 的 m3u 文件方式 2( 推荐, 需联系技术支持配置 ) 方式 3( 需联系技术支持配置 ) MP4 录像方式 1 时长在 10 小时内 MP4 文件时长大于 10h 的 MP4 文件方式 2( 推荐, 需联系技术支持配置 ) 方式 3( 需联系技术支持配置 ) FLV 录像方式 1( 默认 ) 方式 2( 推荐, 需联系技术支持配置 ) 录像回调金山云 1/20

2 MP4/FLV 录像回调 HLS 录像回调直播截图直播截图存储规则自动覆盖回调接口存储规则自动覆盖回调接口转码服务金山云转码服务 (KET) 产品简介产品特性产品架构产品功能产品简介产品特性弹性转码独享机制安全可靠高可扩展产品架构产品功能编码算法和分辨率多种格式配额机制转码操作自定义模板截图水印截取视频信息提取监控机制语言 SDK 金睛服务金睛服务产品概述产品功能产品优势解决方案金睛控制台使用手册计费模式和开通说明产品概述产品功能智能识别一键断流实时报警信息推送截图存档权限管理产品优势目录金山云 2/20

3 目录金山云直播内容安全解决方案方案介绍方案特色金睛控制台使用手册内容安全 1. 分级预警 1.1 最新预警 1.2 预警分布 ( 最新一小时 ) 2. 直播监控墙监控详情页 3. 截图监控墙 4. 监控收录 4.1 智能截图 4.2 断流截图 5. 监控配置 6. 权限管理 6.1 管理员 6.2 监控员附 :IAM 用户介绍新建 IAM 用户删除 IAM 用户查看 IAM 用户列表查看 IAM 用户详情修改用户姓名计费模式和开通说明金睛收费金睛服务开通方式金山云 3/20

4 操作指南推流接入推流接入视频云鉴权简单鉴权旁路鉴权直播推拉流服务 RTMP 推流 RTMP 直播拉流 HLS 直播拉流 HTTP+FLV 直播拉流视频云鉴权简单鉴权金山云支持 MD5 防盗链简单鉴权, 此服务需联系技术支持开通推流示例 rtmp://uniquename.uplive.ks-cdn.com/live/streamname?t= &k=19d55ace3bd 参数说明参数名鉴权方式 t 用来控制失效时间,unix10 位时间戳,190 年 1 月 1 日以来的秒数 k 通过 md5 算法计算出的验证串, 数字和小写英文字母混合 0-9a-z, 固定长度 16, 取中间 16 位 ( 即第 9 位到 24 位 ) 源站服务器拿到请求后, 首先会判断请求中的参数 t 参数是否小于当前时间, 如果小于, 则认为过期失效并返回 HTTP 403 错误如果参数 t 大于当前时间, 则构造出一个同样的字符串然后使用 MD5 算法算出 ha shva l ue 再和请求中带来的参数 k 参数进行比对比对结果一致, 则认为鉴权通过否则鉴权失败, 返回 HTTP 403 错误防盗链算法 ha shva l ue 取 MD5( 秘钥 + 流名 +t 参数 ) 计算得出的 MD5 值中间 16 位, 即第 9 位到 24 位示例说明 1. 用户秘钥设为 :3456( 用户提供 ); 支持字符 : 数字, 字母 ( 区分大小写 ), 最长 32 位 2. 用户访问 url 时间戳 t 参数设为 : 用户 k 参数为 :4fe440240e2 3. 服务器通过计算得出 hashvalue tm p_m d5=md5(3456stream )=c62321f4fe440240e2e5c5bd90 ha shva l ue 取计算结果中间 16 位 : 4fe440240e2 hashvalue 与 url 中 k 参数 4fe440240e2 比较, 完全匹配, 鉴权校验通过 ; 不匹配则拒绝访问外部鉴权金山云支持在客户自己的鉴权服务器使用自身鉴权算法鉴权, 此服务需联系技术支持开通推流示例 rtmp://uniquename.uplive.ks-cdn.com/live/stream?token=3dkbiljaausbh 开启外部鉴权后, 推流地址携带参数 token 为用户携带自定义鉴权字符串 ; 金山云支持以 POST 方式访问客户鉴权服务器直播推拉流服务 R TMP 推流该服务用于提交一个 RTMP 直播流推送请求, 对于推流的返回在 _result 中以 amf 编码返回请求示例 rtmp://uniquename.uplive.ks-cdn.com/live/stream?signature=vu9xqplcxd3nwdlflwihruzrlam%3d&accesskey=p3upcmorafon6q6rtnq&expire= [&nonce=4e1f2519c626cbfbab1520c25530c26] 状态码 Co de SubCo de Descriptio n 0 0 Publish Success ( 推流成功 ) 1 0 Non-Exist Publish Domain( 非法推流域名 ) 2 0 Non-Exist Application( 应用名不存在 ) 3 0 Already Exist Stream Name( 此流已存在 ) 4 0 Forbidden By Blacklist( 黑名单拒绝 ) 5 0 Authentication Failed( 鉴权失败, 原因未知 ) 5 1 Accesskey Or Signature Not Exist( 鉴权失败, 鉴权参数缺失 ) 5 2 URL Expired( 鉴权失败, 签名超时 ) 请求 Co nnect (Invoke) "publish" (Transaction ID) 1.0 (Object1) app: "app", flashver: "MAC 10,2,153,2", swfurl: null, tcurl:"rtmp://*.uplive.ks-cdn.com/live/stream?signature=vu9xqplcxd3nwdlflwihruzrlam%3d&accesskey=p3upcmorafon6q6rtnq&expire= [&nonce=4e1f2519c626cbfbab1520c25530c26]", fpad: false, capabilities: 994.5, audiocodecs: 3191, videocodecs: 252, videofunction: 1, pageurl: null, objectencoding: 3.0 金山云 4/20

5 操作指南 Resul t (Invoke) "_result" (Transaction ID) 1.0 (Object2) code: 0, subcode: 0, description: "Publish Success" R TMP 直播拉流该服务用于提交一个 RTMP 直播流播放请求请求示例 rtmp://***.rtmplive.ks-cdn.com/live/stream 状态码 Co de SubCo de Descriptio n 0 0 Play Success ( 拉流成功 ) 1 0 Non-Exist Play Domain( 非法拉流域名 ) 2 0 Non-Exist Application( 应用名不存在 ) 3 0 Non-Exist Stream Name( 此流不存在 ) 请求 Co nnect (Invoke) "play" (Transaction ID) 1.0 (Object1) app: "app", flashver: "MAC 10,2,153,2", swfurl: null, tcurl:"rtmp://*.rtmplive.ks-cdn.com/live/stream", fpad: false, capabilities: 994.5, audiocodecs: 3191, videocodecs: 252, videofunction: 1, pageurl: null, objectencoding: 3.0 Resul t (Invoke) "_result" (Transaction ID) 1.0 (Object2) code: 0, subcode: 0, description: "Play Success" HL S 直播拉流形如 GET /live/stream/index.m3u, 此请求提交了一个 HLS 请求请求示例 GET /live/stream/index.m3u HTTP/1.1 Host: ***.hlslive.ks-cdn.com Date:Wed, 2 Oct :32:00 GMT 成功响应示例 HTTP/ OK Content-Length: length Content-Type: text/plain Date:Wed, 2 Oct :32:00 GMT Server: Nginx #EXTM3U #EXT-X-VERSION:3 #EXT-X-MEDIA-SEQUENCE:0 #EXT-X-TARGETDURATION:2 #EXTINF:2.000, 210.ts #EXTINF:2.000, 4510.ts #EXTINF:1.315, 6310.ts 错误响应示例 1. 鉴权失败 HTTP/ Forbidden Content-Length: length Content-Type: text/plain Date: Wed, 2 Oct :32:00 GMT Server: Nginx <?xml version="1.0" encoding="utf-"?> <Error> <Code>AuthencationFailed</Code> <Message>Non Exist Signature or Accesskey</Message> </Error> 2. 应用不存在 HTTP/ Forbidden Content-Length: length Content-Type: text/plain Date: Wed, 2 Oct :32:00 GMT Server: Nginx <?xml version="1.0" encoding="utf-"?> <Error> <Code>NonExistApplication</Code> </Error> 3. 流不存在 HTTP/ Forbidden Content-Length: length Content-Type: text/plain Date: Wed, 2 Oct :32:00 GMT Server: Nginx <?xml version="1.0" encoding="utf-"?> <Error><Code>NonExistStreamName</Code> </Error> 返回错误 Erro r Descriptio n 金山云 5/20

6 操作指南 AuthencationFailed 鉴权失败 NonExistApplication application 应用名不存在 ExistStreamName publish 流名已存在 HTTP + F L V 直播拉流请求示例 GET /live/stream.flv HTTP/1.1 Host: ***.hdllive.ks-cdn.com Date:Wed, 2 Oct :32:00 GMT 错误响应示例 HTTP/ OK Cache-Control: no-cache Content-Type: video/x-flv Connection: close Expires: -1 Pragma: no-cache [Media Data] 旧版开播断流回调注意 : 控制台开通后默认为旧版回调, 建议联系技术支持开通新版回调用于通知 RTMP 推流开始和结束的回调 url 为 HTTP POST, 回调接口包括流所属的频道 app, 流名 name, 推流时携带的 flashver & swfurl & tcurl, 以及本次请求的类型 call 对于推流开始,call 的值为 user_publish; 对于推流结束,call 的值为 user_publish_done 开播回调当 RTMP 推流成功后, 会调用相应的回调接口, 回调接口具体的结构如介绍中所示例 HTTP Body app=live&name=asdf&swfurl=nil&flashver=nil&tcurl=rtmp://test.uplive.ks-cdn.com/live&call=user_publish&vdoid=3456 回调接口包括流所属的频道 app, 流名 name, 推流时携带的 flashver & swfurl & tcurl, 以及本次请求的类型 call 对于推流开始,call 的值为 user_publish; 对于推流结束,call 的值为 user_publish_done 参数说明参数示例 app live 频道 name asd 流名 flashver MAC 10,2,153,2 用于播放 SWF 文件的 Flash 播放器版本 swfurl swl 文件播放 url, 无默认值 tcurl rtmp://test.uplive.ks-cdn.com/live/stream 推流 url call user_publish 请求类型 ( 推流开始 :user_publish; 推流结束 :user_publish_done) vdoid 3 用于标识文件是否拼接关播回调当 RTMP 推流结束后, 会调用相应的回调接口, 回调接口具体的结构如介绍中所示例 HTTP 头 POST /callback HTTP/1.0 Host: 用户提供的通知 Host Connection: close Content-Length: HTTP Body app=live&name=asdf&swfurl=nil&flashver=nil&tcurl=rtmp://test.uplive.ks-cdn.com/live&call=user_publish_done&close_mode=nil&vdoid=3456 参数说明参数示例 app live 频道 name asd 流名 flashver MAC 10,2,153,2 用于播放 SWF 文件的 Flash 播放器版本 swfurl swl 文件播放 url, 无默认值 tcurl rtmp://test.uplive.ks-cdn.com/live/stream 推流 url call user_publish 请求类型 ( 推流开始 :user_publish; 推流结束 :user_publish_done) close_mode 1 推流断开类型 (1: 正常断开,2: 异常断开 ) vdoid 3 用于标识相同流名的不同次推流返回错误 Erro r Descriptio n AuthencationFailed 鉴权失败 NonExistApplication app 频道不存在 ExistStreamName publish 流名已存在新版开关播回调 json 格式注意 : 如需开通, 请联系技术支持开播回调当 RTMP 推流成功后, 会调用相应的回调接口, 回调内容如下 : 参数类型示例 Version String 版本号 1.0 App String 频道 live Pubdomain String 推流域名 xxx.xxx.com Stream String 流名 3 PubStartUnixTime Long 推流开始时间, 位 unixtime 毫秒时间戳 NotifyType String 回调类型,PubStart: 推流开始,PubEnd: 推流结束 PubStart PubParam Object 推流携带的参数金山云 6/20

7 操作指南 ClientIp String 推流端 IP ClientPort Int 推流端端口 Node String cdn 接受流的节点开播回调示例 "Version":"1.0", "App":"live", "Pubdomain":"xxx.xxx.com", "Stream":"test", "PubStartUnixTime":" ", "NotifyType":"PubStart", "ClientIp":" ", "ClientPort":" ", "Node":" ", "PubParam": "param1":"3456", "param2": 关播回调当 RTMP 推流结束后, 会调用相应的回调接口, 回调内容如下 : 参数类型示例 Version String 版本号 1.0 App String 频道 live Pubdomain String 推流域名 xxx.xxx.com Stream String 流名 3 PubEndUnixTime Long 推流结束时间, 位 unixtime 毫秒时间戳 NotifyType String 回调类型,PubStart: 推流开始,PubEnd: 推流结束 PubEnd PubParam Object 推流携带的参数 ClientIp String 推流端 IP ClientPort int 推流端端口 Node String cdn 接受流的节点关播回调示例 "Version":"1.0", "App":"live", "Pubdomain":"xxx.xxx.com", "Stream":"test", "PubEndUnixTime":" ", "NotifyType":"PubEnd", "ClientIp":" ", "ClientPort":" ", "Node":" ", "PubEndMessage":" ", "PubParam": "param1":"3456", "param2": 延时直播延时直播产品介绍简单地说, 延时直播就是节目播出的时间, 要比直播推流开始的时间有一定的延迟延时的目的是为监播人员提供一定的监播时间, 以防止不利于社会稳定和安全的画面及语言播出国家广电总局规定, 有群众参与的电视节目必须延时播出 20 秒以上延时直播绝非录播录播是指播出前把整档节目按播出要求编辑录制, 做成完整节目的播出带, 按规定播出时间进行播放的方式应用场景为保障播出内容审核无误, 向直播监播人员提供一定的监播时间, 提前发现不利于社会稳定和安全的画面及语言, 及时阻断直播内容播出产品优势充分延时时长金山云延时直播支持 1min-5min 的延时时间, 预留出充足的时间供监控人员对直播内容进行审核, 保证播出内容安全健康延时直播二期将支持延时时长 1min-30min, 敬请期待源流供监控源流顾名思义就是没有进行延时处理的直播流, 可提供到监控人员进行播出前内容审核, 保障播出内容安全延播流供观看延播流顾名思义就是进行了延时处理的直播流, 可将审核过的安全直播内容分发给观众观看 ; 亦可对此路流开启录像生成回看秒级禁播提供禁播接口, 若监控人员发现不利于社会稳定和安全的画面及语言, 可及时将源流或者延播流阻断, 防止不健康内容播出开通说明此内容正在更新中, 请咨询商务人员直播录像 HLS 录像 MP4 录像 FLV 录像录像回调概念解释开通流程直播录像服务是将直播原始流经过音视频转封装格式 ( 不修改编码方式音视频数据以及对应的时间戳等信息 ) 得到的录制文件存储到 KS3 的服务金山云 /20

8 操作指南说明直播录像服务需要在直播控制台开通并配置存储 bucket 和回调 url, 所以需要同时开通金山云存储 KS3 服务, 具体请咨询商务人员帮助您开通直播录像存储目前仅支持北京 region 直播录像是对音视频封装格式的转换, 不修改编码参数, 因此当同一个录制文件前后编码参数不一致时, 可能导致 MP4 FLV 录制文件异常当相同流名前后推流编码参数不一致时建议关闭拼接功能, 若有拼接需求可通过媒体处理解决若开通 MP4/FLV 录像功能, 必须先开启 HLS 录像金山云录制默认开启自动拼接功能, 同流名的文件会拼接为一个录制文件推流 URL 携带 vdoid 参数示例 rtmp://uniquename.uplive.ks-cdn.com/live/stream?vdoid= H LS 录像方式 1( 默认 ) 时长在 10 小时内 m 3u 文件命名规则 :stream-vdoid.m3u 存储路径 :/record/app/stream/hls/stream-vdoid.m3u 目录说明目录 record 根目录, 用于方便管理 app 频道名, 推流携带, 默认 live stream 流名, 推流携带 hls 存放 m3u 文件目录 sessionid 唯一标识符时长大于 10h 的 m 3u 文件若拼接文件时长大于 10h, 每隔 10h 文件会生成一个名为 streamid-vdoid- 时间戳.m3u 的文件上传到 ks3, 最后生成文件若时间不足 10h, 仍命名为 stream-vdoid.m3u 上传到 ks3 金山云支持 m3u 文件自动覆盖功能, 若开启此功能请联系技术支持 ; 开启后, 同流名 vdoid 每次推流生成的 m3u 会自动覆盖为名为 stream-vdoid.m3u 的文件上传至 ks3 方式 2( 推荐, 需联系技术支持配置 ) 录像生成规则 : 同流名 5min( 可配, 默认 10h) 内断流重推对录像文件进行拼接, 录像总时长超过 4h( 可配, 默认关闭 ) 进行切割路径 :/record/app/stream/hls/ 命名 :[ 流名 ]-[ 文件开始时间 ]-[ 文件结束时间 ].m3u 示例 : stream_ _ m3u 方式 3( 需联系技术支持配置 ) 录像生成规则 : 同流名 5min( 可配 ) 内断流重推录像进行拼接, 录像总时长超过 4h( 可配 ) 进行切割 ; 路径 :/record/app/stream/hls/ 命名 :[ 流名 ]-[ 年月日 ]-[ 时分秒 ]-[unix 毫秒时间戳末三位 ]-[ 切割后缀 ].m3u 示例 : stream m3u ( 切割第一段 ) stream m3u ( 切割第二段 ) stream m3u ( 切割第三段 ) [ 年月日 ]-[ 时分秒 ]-[unix 毫秒时间戳末三位 ]: 为最初推流开始时间过期存储 : 录像支持 60 天过期存储 MP4 录像过期存储 : 文件保存时间可以自定义修改, 在 KS3 平台做操即可方式 1 金山云点播文件默认开启自动拼接, 存储空内同 stream vodid 的文件会自动进行拼接, 若开启 MP4 点播, 请推流时携带 vdoid 参数时长在 10 小时内 MP4 文件命名规则 :vdoid.mp4 存储路径 : 绑定 bucket 的主目录下时长大于 10h 的 MP4 文件若拼接文件时长大于 10 小时, 每隔 10h 文件会生成一个名为 vdoid- 时间戳.mp4 的文件上传到 ks3, 最后生成文件若时间不足 10h, 仍命名为 vdoid.mp4 上传到 ks3 金山云支持 MP4 文件自动覆盖, 开启此功能需联系商务 ; 开启后, 同流名 vdoid 每次推流生成的 m3u 会自动覆盖为名为 vdoid.mp4 的文件上传至 ks3 方式 2( 推荐, 需联系技术支持配置 ) 录像生成规则 : 同流名 5min( 可配, 默认 10h) 内断流重推对录像文件进行拼接, 录像总时长超过 4h( 可配, 默认关闭 ) 进行切割 ; 路径 : 默认存在 bucket 下, 支持配置 /record/app/stream/mp4/ 命名 :[ 流名 ]-[ 文件开始时间 ]-[ 文件结束时间 ].mp4 示例 : stream_ _ mp4 方式 3( 需联系技术支持配置 ) 录像生成规则 : 同流名 5min( 可配 ) 内断流重推录像进行拼接, 录像总时长超过 4h( 可配 ) 进行切割路径 :/record/app/stream/mp4/ 命名 :[ 流名 ]-[ 年月日 ]-[ 时分秒 ]-[unix 毫秒时间戳末三位 ]-[ 切割后缀 ].mp4 金山云 /20

9 操作指南示例 : stream mp4 ( 切割第一段 ) stream mp4( 切割第二段 ) stream mp4 ( 切割第三段 ) [ 年月日 ]-[ 时分秒 ]-[unix 毫秒时间戳末三位 ]: 为最初推流开始时间 FLV 录像过期存储 : 文件保存时间可以自定义修改, 在 KS3 平台做操即可方式 1( 默认 ) 录像生成规则 : 同流名 5min( 可配 ) 内断流重推录像进行拼接, 录像总时长超过 4h( 可配 ) 进行切割 ; 路径 :/record/app/stream/flv/ 命名 :[ 流名 ]-[ 年月日 ]-[ 时分秒 ]-[unix 毫秒时间戳末三位 ]-[ 切割后缀 ].flv 示例 : stream flv( 切割第一段 ) stream flv( 切割第二段 ) stream flv ( 切割第三段 ) [ 年月日 ]-[ 时分秒 ]-[unix 毫秒时间戳末三位 ]: 为最初推流开始时间过期存储 : 录像支持 60 天过期存储, 即过期时间为 60 天方式 2( 推荐, 需联系技术支持配置 ) 录像生成规则 : 同流名 5min( 可配, 默认 10h) 内断流重推对录像文件进行拼接, 录像总时长超过 4h( 可配, 默认关闭 ) 进行切割 ; 路径 :/record/app/stream/flv/ 命名 :[ 流名 ]-[ 文件开始时间 ]-[ 文件结束时间 ].flv 示例 : stream_ _ flv 录像回调 MP4/FLV 录像回调回调 url 配置用户在使用时需要在云直播控制台配置生成点播文件后的回调 url, 回调 url 为 HTTP POST 回调示例 "taskid":"xxxxx", "status":3, "type":"avtrans", // 旧版收录格式, 不建议使用 "itmes":[ "cmd":"tag=avtranstag=saveas&bucket=media-kslive&object=ytmwngqznzqzztdhngrmnme1nzawzjkxndjhy2rjztlfdmrvawqymde3mdkwnc5tcdq=", "desc":"success", "keys":[ "xxxxx.mp4" ], "code":3 ], "details": "errnum":0, "bucket":"xxxx", "starttime":" ", "endtime":" ", "streamid":"xxxx", "throughparams":"xxxx", "items":[ "dstpath":"xxxxx.mp4", "ETag":"cb1b99f665c91dac6c19cd991a1", "outmediainfo":""metadata":,"format":"format_name":"mp4","size": ,"duration":"5241","bit_rate":156024,"streams":["codec_name":"h264","codec_type":"video","width":0,"height": 20,"r_frame_rate":"25/1","index":1,"codec_name":"aac","codec_type":"audio","channels":2,"sample_rate":32000]" ] 参数说明字段名类型是否必有 taskid string 是任务 ID status int 是任务状态 :3 为成功,4 为失败 type string 是任务类型, 与创建任务时使用的模板类型一致 details json object 是更详细的信息对 deta il s 更详细的说明 : 字段名类型是否必有 errnum int 是视频信息 errmsg string 是视频 metadata bucket string 是视频流信息列表 streamid string 否流名 starttime string 否该流起始时间 endtime string 否该流结束时间 throughparams string 否透传参数 items json array 是回调中用户定制的输出文件信息等对 item s 更详细的说明 : 字段名类型是否必有 dstpath int 是输出文件在 ks3 的相对路径 ETag string 是视频内容的 md5 值金山云 9/20

10 操作指南 outmediainfo string 是 avtrans 任务的回调字段, 输出视频的信息 string 类型,string 内部是 json 串对输出文件信息 outmediainfo 的说明字段名类型是否必有 metadata json object 是视频 metadata streams json array 是视频流信息列表 format json object 是视频文件信息 m eta da ta 部分字段名类型是否必需 rotate string 否旋转信息 strea m s 部分字段名类型是否必需 index int 是序号 codec_type string 是流类型 codec_name string 是编码格式 bit_rate int 是码率, 单位 bps width int 否宽 height int 否高 r_frame_rate string 否帧率 channels int 否声道数 sample_rate int 否音频采样率 f o rm a t 部分字段名类型是否必需 duration string 是文件时长, 单位秒 format_name string 是文件容器格式 size int 是文件大小, 单位字节 HLS 录像回调回调 url 配置用户在使用时需要在云直播控制台配置生成点播文件后的回调 url, 回调 url 为 HTTP POST HLS 录像回调在断流后统一回调客户, 例如客户配置的是 2 小时切割,5min 断流拼接, 一次推流是 5 个小时, 在 5 小时断流并且断流后 5min 内不再次重推后会回调一次, 回调内包含 3 个切割文件, 示例如下 : 回调示例 "status":3, "taskid":" aa9fc", "itmes":[ "cmd":"", "desc":"success", "keys":[ "record/app/stream/hls/stream m3u", "record/app/stream/hls/stream m3u", "record/app/stream/hls/stream m3u" ], "vdoid":"", "code":3 ], "mediasize":0 参数说明参数示例 status 3 任务执行的状态 (3: 成功 ;4: 失败 ) taskid 00PNwad2wdoO 执行本次点播操作的唯一 id desc success 任务执行的结果 keys /streamname/1.m3u 生成的 m3u 点播文件名 code 3 执行返回的代码直播截图直播截图存储规则自动覆盖回调接口金山云直播截图服务需要用户在控制台申请开通, 并配置生成的截图文件存放目的 bucket 和生成截图文件后的回调 url, 以及截图生成的间隔时间, 目前原始截图文件只支持 jpg 格式如需对图片进行后期处理, 请参考图片处理详解存储规则命名规则 :stream- 时间戳.jpg 存储路径 :record/app/stream/picture/ 毫秒时间戳 -sessionid/stream- 时间戳.jpg 目录说明目录 record 根目录, 用于方便管理 app 频道名, 推流携带, 默认 live stream 流名, 推流携带 picture 存放截图文件的目录 sessionid 唯一标示符自动覆盖金山云支持直播截图自动覆盖, 开启此功能需联系技术支持金山云 10/20

11 操作指南命名规则 :stream.jpg 存储路径 :record/app/stream/picture/stream.jpg 回调接口配置回调 url 用户在使用时需要在云直播控制台配置生成截图文件后的回调 url, 回调 url 为 HTTP POST 回调示例 "status": 3, "taskid": "xxx", // deprecated "items": [ "cmd": "tag=avop&f=mp4&res=0x20&vbr=1500k&abr=k tag=saveas&bucket=xxx&object=cmvjb3jkl3vwbg9hzc9wmtq1ntuwodqyndexmjy3oc9wmtq1ntuwodqyndexmjy3oc5tcdq=", "desc": "success", "keys": [ "record/upload/v /xxx.jpg" ], "code": 3 ], "type" : "LiveSnapShotCallBack", // 标识该调用类型 "details" : "errnum" : 0, // 错误码 "errmsg" : "", // 错误码, 非必选 "uniqname" : "myuniqname", // 用户标识 "stream_name" : "345", // 流名 "timestamp" : , // 截图产生的时间点 "bucket" : "mybucket" // 截图所在的用户 bucket "items" : [ // 支持多个输出 "output_format" : 0, // deprecated, 标识转码参数 "width" : 40, // 图片的宽 "height" : 360, // 图片的高 "shortside" : 360, // 用户指定的短边长度由于不允许小转大, 用户设置值, 不一定就是最终输出的宽高中短的一边如果不设置, 回调中不带 "quality" : 5, // 用户指定的图片的质量系数, 如果是默认质量, 则回调中不带 "dstpath" : "upic/2016/05//live/1.jpg" // 截图在 bucket 中的路径, 如果上传失败, 该值为空, 可以使用 alterurl 直播下载,... ] 参数说明参数示例 status 3 任务执行的状态 (3: 成功 ;4: 失败 ) taskid xxx 执行本次点播操作的唯一 id desc success 任务执行的结果 keys record/upload/v /xxx.jpg 截图路径 code 3 执行返回的代码 type LiveSnapShotCallBack 标识该调用类型 errnum 0 错误码 errmsg xxx 错误 uniqname myuniqname 域名标识 stream_name 3 流名 timestamp 截图产生的时间点 bucket mybucket 截图所在的用户 bucket output_format 0 标识转码参数, 代表截图输出参数 width 40 图片的宽 height 360 图片的高 shortside 360 用户指定的短边长度由于不允许小转大, 用户设置值, 不一定就是最终输出的宽高中短的一边如果不设置, 回调中不带 quality 5 用户指定的图片的质量系数, 如果是默认质量, 则回调中不带 dstpath upic/2016/05//live/1.jpg 截图在 bucket 中的路径, 如果上传失败, 该值为空, 可以使用 alterurl 直播下载转码服务金山云转码服务 (K ET) 产品简介产品特性产品架构产品功能产品简介金山云转码服务 KET(Kingsoft Elastic Transcoder) 提供媒体转码直播转码服务, 支持多码率多分辨率, 线上多节点分布式转码集群提供高可用可靠高效的转码服务产品特性弹性转码分布式转码集群, 成熟编码算法, 为客户提供高质量快速弹性的转码服务独享机制保证任何时候, 有配额情况下对相当的复杂度的任务数可以被同时执行并可以将紧急任务置顶获取快速转码安全可靠 X24 小时服务支持, 提供 99.9% 高可用服务高可扩展提供丰富媒体处理, 切片截图水印截取信息提取等, 根据需要自定义模板金山云 /20

12 操作指南产品架构产品功能编码算法和分辨率支持 H.264,H.265;2K,4K,20P,100P 等多种格式支持全部主流封装格式和编码格式配额机制用户根据 CPU 核数或并发路数设置配额参数转码操作将不同媒体格式的文件以不同的分辨率比特率和帧速等设定转换成 HLS/MP4 文件的计算工作自定义模板用户通过模板中参数类型自定义符合要求模板类型截图支持对 KS3 上的视频进行截图, 并根据时间点生成单张图片或者根据采样点生成多长采样截图水印可以将 KS3 上的 png 水印图片根据用户设定位置覆盖到视频中, 并支持水印图片的自动缩放截取根据指定起始时间点, 截取指定时长的媒体文件视频信息提取提取 KS3 上视频文件参数信息监控机制提供全面任务查询机制和任务结束回调机制语言 SD K 提供 PHP java 和 python 语言 SDK 接入服务金睛服务金睛服务产品概述产品功能产品优势解决方案金睛控制台使用手册金山云 /20

13 操作指南计费模式和开通说明产品概述金睛 (KingIntelligentEyes) 是金山云针对淫秽色情暴恐群体性事件等网络视频内容人工监管困难的现状, 为净化网络环境, 给客户提供的视频内容安全智能监管解决方案金山云基于深度学习图片识别技术, 高效准确地对视频内容进行色情暴恐群体性事件的识别, 提高客户审核效率, 解决审核成本金山视频云内容安全智能审核平台金睛提供一站式视频内容安全解决方案, 提供图形化审核控制台和完善的开放接口, 客户可根据现状自主组合定制内容安全解决方案产品功能智能识别支持识别直播内容中色情, 性感, 暴恐, 群体性事件四种不良信息, 可选择分别开启或关闭, 可根据客户自身的直播场景配置识别的阈值, 阈值范围为 0-100%, 阈值设置越大识别到的截图越接近以上四种类型智能鉴黄 : 高效准确地识别直播视频的色情 / 性感内容, 准确率高达 99% ; 暴恐识别 : 高效准确地识别直播视频的暴恐内容, 准确率高达 99% ; 群体性事件识别 : 高效准确地识别直播视频的群体性事件内容, 准确率高达 99% ; 一键断流客户发现直播流含不良信息后, 可通过在金睛控制台上直接一键断流操作或者调用断流接口将直播流拉入黑名单, 若监控人员不小心误操作, 也支持一键恢复直播流的推送实时报警在金睛控制台上若智能识别到监控墙上某路流含不良信息, 此路流会闪红报警, 提醒人工审核人员重点关注信息推送客户可设置回调 URL, 实时通知智能监控预警信息截图存档对人工监控进行断流操作时的截图和机器识别到不良信息的截图进行存档取证权限管理金睛控制台使用主账号和 IAM 用户来区分管理员和监控员的权限, 主账号拥有金睛控制台管理权限, 可以查看并操作云直播控制台上包含金睛控制台在内的任何操作,IAM 用户拥有金睛控制台监控权限, 只能查看分级预警, 直播 / 截图监控墙, 监控收录和阻断 / 恢复单路流推送操作产品优势优势详情无缝对接易接入, 开通内容安全平台, 快速生成直播监控墙灵活应用完善的底层接口, 客户可根据现状自主组合定制内容安全解决方案解放人力机器协助监控, 识别准确率高, 有效解放审核人力高效处理即时发现不良信息即时报警回调信息, 审核人员高效处理权限管理平台登录人员区分权限, 监控人员只可对监控直播流操作, 管理员可设置阈值等配置操作监控内容全覆盖对涉及淫秽色情, 暴恐, 群体性事件等各种不良信息的直播内容进行全方位覆盖监控金山云直播内容安全解决方案方案介绍金山云金睛解决方案, 主要解决直播行业的色情直播暴恐识别群体性事件识别等问题解决方案涵盖 PaaS 和 SaaS 一站式服务, 用户可以根据自身需求定制适应自身的安全解决方案, 也可用使用金山金睛 SaaS 平台, 立刻启动人工监控方案特色特色详情监控墙金睛平台一站式解决方案, 直接对接金山云直播控制台生成直播监控墙, 开启人工审核一键断流对含有不良信息的直播视频可进行一键断流监控内容全面覆盖对涉及淫秽色情, 暴恐, 群体性事件等各种不良信息的直播内容进行全方位覆盖监控自定义监控阈值客户可根据自身直播场景对色情, 暴恐, 群体监控自定义设置报警阈值收录存档对报警截图和断流截图进行存档留证金睛控制台使用手册客户开通金睛服务之后, 云直播控制台上可见内容安全模块 ( 申请开通金睛平台的前提是客户已开通金山云视视频云服务 ), 使用金山云主账号登录云直播控制台, 可以查看和操作云直播控制台上的任何模块, 在此重点介绍内容安全的分级预警直播监控墙截图监控墙监控收录和监控配置模块 : 内容安全 1. 分级预警分级预警页面包含最新预警最新预警和预警分布预警分布 ( 最近一小时 ) 的数据展示, 如图金山云 /20

14 操作指南最新预警最新预警部分记录的是最新智能识别到的含色情 / 性感 / 暴恐 / 群体信息的流的相关信息 : 威胁程度, 流名, 类型, 更新日期, 截图, 操作最新预警说明威胁程度分为高威胁 ( 色情暴恐 ) 和低威胁 ( 性感群体 ) 流名每个流名只显示一条记录, 例如流 stream1 的两张截图均检测到色情, 只显示最新记录, 可查看最新的截图类型识别预警的截图类型, 支持色情性感暴恐和群体性事件的识别, 具体识别预警类型客户可自定义配置更新日期此路流最新识别到不良信息截图的时间截图此路流最新预警的截图操作可对预警流进行断流或者恢复的操作, 断流 : 将此路流拉入黑名单, 恢复 : 将此路流拉出黑名单 1.2 预警分布 ( 最新一小时 ) 使用饼图和柱状图展示最新一小时预警截图在各种识别类型上的分布情况 2. 直播监控墙直播监控墙用于展示客户实时直播流, 可适应不同屏幕选择每一页的直播流展示数量 (/24/36), 方便人工审核人员在不同屏幕上进行实时监控和根据人力分配直播流监控数, 可根据流名查询某路流的直播内容, 如图金山云 14/20

操作指南 2019--26 注意 : 直播监控墙现只支持 rtmp 播放格式, 会产生相应 CDN 费用监控详情页

截图监控墙截图监控墙用于展示客户实时直播流, 可适应不同屏幕选择每一页的直播流展示数量 (/24/36),

15 操作指南注意 : 直播监控墙现只支持 rtmp 播放格式, 会产生相应 CDN 费用监控详情页点击直播流上任意空白处可进入监控详情页, 查看色情性感暴恐和群体的智能识别截图结果, 如图 3. 截图监控墙截图监控墙用于展示客户实时直播流, 可适应不同屏幕选择每一页的直播流展示数量 (/24/36), 方便人工审核人员在不同屏幕上进行实时监控和根据人力分配直播流监控数, 可根据流名查询某路流的直播内容, 点击截图的任意空白处也可进入监控详情页, 截图监控墙如图 : 金山云 15/20

16 操作指南监控收录监控收录展示收录的智能预警截图和断流存档截图信息, 支持不同时间段不同类型不同流名查询 4.1 智能截图智能截图里收录了智能检测预警的所有截图信息, 如图 : 金山云 16/20

17 操作指南智能截图说明创建时间本张截图的创建时间文件名称截图的文件名称, 点击可查看截图内容流名本张截图的所属流名类型 / 匹配度类型 : 识别预警的截图类型, 支持色情性感暴恐和群体性事件的识别, 具体识别预警类型客户可自定义配置匹配度 : 识别类型的匹配度操作可对截图进行删除操作 4.2 断流截图断流操作时生成的截图存档文件, 注意如果推流开始时间过短就进行断流操作, 可能不会生成截图, 因为截图任务未启动断流截图断流时间文件名称流名操作说明 5. 监控配置进行断流操作是时间点截图的文件名称, 点击可查看截图内容本张截图的所属流名可对本条流进行断流 / 恢复直播流推动的操作 ; 可删除本条断流记录, 截图文件也一并删除监控配置页面上可进行监控识别类型 ( 色情性格暴恐群体 ) 阈值存储空间和通知 URL 的配置, 如图断流截图说明色情识别可选择开启 / 关闭, 开启即开启了截图的色情和性感的识别, 阈值可分别配置, 阈值范围为 0-100% 暴恐识别可选择开启或者关闭, 开启即开启截图的暴恐识别, 可设置阈值, 阈值范围为 0-100% 金山云 1/20

操作指南 2019--26 群体性事件识别可选择开启或者关闭, 开启即开启截图的群体性事件识别, 可设置阈值, 阈值范围为 0-100% 存储空间必填项, 需绑定 ks3 已有 bucket 其 region, 用于收录监控截图文件, 注意 : 此处绑定 bucket 的 region 需与全局配置 -> 直播截图里绑定 bucket 的 region 相同通知 URL 可选填项,

18 操作指南群体性事件识别可选择开启或者关闭, 开启即开启截图的群体性事件识别, 可设置阈值, 阈值范围为 0-100% 存储空间必填项, 需绑定 ks3 已有 bucket 其 region, 用于收录监控截图文件, 注意 : 此处绑定 bucket 的 region 需与全局配置 -> 直播截图里绑定 bucket 的 region 相同通知 URL 可选填项, 可绑定客户通知回调的 URL 6. 权限管理金睛平台使用主账号和 IAM 用户来区分不同的权限, 主账号拥有金睛平台管理权限, 可以查看并操作云直播控制台上包含金睛平台在内的任何操作,IAM 用户拥有金睛平台监控权限, 只能查看分级预警, 直播 / 截图监控墙, 监控收录和阻断 / 恢复单路流推送操作 6.1 管理员使用主账号登录金睛平台, 拥有管理员权限, 可以查看并操作云直播控制台上包含金睛平台在内的任何操作, 如图 : 6.2 监控员使用 IAM 用户登录金睛平台, 拥有监控员权限, 只能查看和操作内容安全模块的分级预警, 直播监控墙, 截图监控墙, 监控收录, 如图金山云 1/20

操作指南 2019--26 附 :IAM 用户介绍新建 IA M 用户主账户或者授权的 IAM 用户可以为主账户创建新的 IAM 用户, 操作如下 : 1. 使用主账户或者已授权的 IAM 用户身份登录控制台 ( 新版 ) 2. 选择身份与管理一级菜单 -> 选择身份与访问控制二级菜单 -> 选择用户管理三级菜单 3.

19 操作指南附 :IAM 用户介绍新建 IA M 用户主账户或者授权的 IAM 用户可以为主账户创建新的 IAM 用户, 操作如下 : 1. 使用主账户或者已授权的 IAM 用户身份登录控制台 ( 新版 ) 2. 选择身份与管理一级菜单 -> 选择身份与访问控制二级菜单 -> 选择用户管理三级菜单 3. 在用户管理列表页面, 点击新建按钮, 进入创建用户对话框, 如下图输入用户名和姓名后, 点击确定按钮, 完成 IAM 用户的创建 4. 在创建 IAM 用户的同时可以勾选勾选为该 IAM 用户生成访问密钥删除 IA M 用户在 IAM 用户的身份不再被使用时, 可以删除 IAM 用户, 操作如下 : 1. 使用主账户或者已授权的 IAM 用户身份登录控制台 ( 新版 ) 2. 选择身份与管理一级菜单 -> 选择身份与访问控制二级菜单 -> 选择用户管理三级菜单 3. 在用户管理列表页面, 选择一个或多个欲删除的 IAM 用户, 点击删除按钮, 进入创建用户对话框, 如下图确认待删除用户无误后, 点击确定按钮, 完成相关 IAM 用户的删除注 : 通过控制台删除 IAM 用户时, 其附加的策略, 访问密钥和登录配置都会被一并删除查看 IA M 用户列表能够查看当前主账户下的 IAM 用户的列表信息, 操作如下 : 1. 使用主账户或者已授权的 IAM 用户身份登录控制台 ( 新版 ) 2. 选择身份与管理一级菜单 -> 选择身份与访问控制二级菜单 -> 选择用户管理三级菜单 3. 在用户管理列表页面, 能够查看当前主账户的 IAM 用户列表, 如下图金山云 19/20

20 操作指南列表项包括 : 用户名姓名密码状态 ( 是否已设置 ) 访问密钥状态用户创建时间操作列表查看 IA M 用户详情能够查看当前主账户下的 IAM 用户的详细信息, 操作如下 : 1. 使用主账户或者已授权的 IAM 用户身份登录控制台 ( 新版 ) 2. 选择身份与管理一级菜单 -> 选择身份与访问控制二级菜单 -> 选择用户管理三级菜单 3. 在用户管理列表页面, 点击 IAM 用户名, 进入用户详情页面, 如下图 4. 页面上部显示 IAM 用户基本信息和操作按钮, 其中基本信息包括 : 用户名姓名密码状态创建时间 KRN 和路径 ; 页面下部显示用户附加策略 tab 页和用户访问密钥 tab 页修改用户姓名能够修改某 IAM 用户的姓名, 操作如下 : 1. 使用主账户或者已授权的 IAM 用户身份登录控制台 ( 新版 ) 2. 选择身份与管理一级菜单 -> 选择身份与访问控制二级菜单 -> 选择用户管理三级菜单 3. 在用户管理列表页面, 点击某 IAM 用户的姓名旁边的小图标 ( 鼠标划过显现 ), 或者进入用户详情页面点击修改姓名按钮, 都可以对 IAM 用户的姓名进行修改注 : 修改 IAM 用户的姓名不影响任何策略授权结果, 而 IAM 用户名不允许修改计费模式和开通说明金睛收费此内容正在更新中, 请咨询商务人员金睛服务开通方式此内容正在更新中, 请咨询商务人员金山云 20/20

停止混流接口请注意 : 该功能需要联系 ZEGO 技术支持开通 1 接口调用说明 http 请求方式 : POST/FORM, 需使用 https 正式环境地址 access_token=access_token (http

停止混流接口请注意 : 该功能需要联系 ZEGO 技术支持开通 1 接口调用说明 http 请求方式 : POST/FORM, 需使用 https 正式环境地址 access_token=access_token (http 停止混流接口请注意 : 该功能需要联系 ZEGO 技术支持开通 1 接口调用说明 http 请求方式 : POST/FORM, 需使用 https 正式环境地址 https://webapi.zego.im/cgi/stop-mix? access_token=access_token (https://webapi.zego.im/cgi/stop-mix? access_token=access_token)