目录 2019--26 目录 目录推流接入推流接入视频云鉴权直播推拉流服务视频云鉴权简单鉴权外部鉴权直播推拉流服务 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 4 4 4 4 4 4 4 4 4 5 5 6 6 6 6 6 6 9 9 9 9 金山云 1/20
9 10 10 10 10 10 10 10 10 MP4/FLV 录像回调 HLS 录像回调直播截图直播截图存储规则自动覆盖回调接口存储规则自动覆盖回调接口转码服务金山云转码服务 (KET) 产品简介产品特性产品架构产品功能产品简介产品特性弹性转码独享机制安全可靠高可扩展产品架构产品功能编码算法和分辨率多种格式配额机制转码操作自定义模板截图水印截取视频信息提取监控机制语言 SDK 金睛服务金睛服务产品概述产品功能产品优势解决方案金睛控制台使用手册计费模式和开通说明产品概述产品功能智能识别一键断流实时报警信息推送截图存档权限管理产品优势目录 2019--26 金山云 2/20
目录 2019--26 金山云直播内容安全解决方案方案介绍方案特色金睛控制台使用手册内容安全 1. 分级预警 1.1 最新预警 1.2 预警分布 ( 最新一小时 ) 2. 直播监控墙监控详情页 3. 截图监控墙 4. 监控收录 4.1 智能截图 4.2 断流截图 5. 监控配置 6. 权限管理 6.1 管理员 6.2 监控员附 :IAM 用户介绍新建 IAM 用户删除 IAM 用户查看 IAM 用户列表查看 IAM 用户详情修改用户姓名计费模式和开通说明金睛收费金睛服务开通方式 14 14 14 15 15 16 16 1 1 1 1 1 19 19 19 19 20 20 20 20 20 金山云 3/20
操作指南 2019--26 推流接入 推流接入 视频云鉴权 简单鉴权 旁路鉴权 直播推拉流服务 RTMP 推流 RTMP 直播拉流 HLS 直播拉流 HTTP+FLV 直播拉流 视频云鉴权 简单鉴权 金山云支持 MD5 防盗链简单鉴权, 此服务需联系技术支持开通 推流示例 rtmp://uniquename.uplive.ks-cdn.com/live/streamname?t=156009663&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 http://uplive.ks-cdn.com/live/stream?t=1560096&k=4fe440240e2 时间戳 t 参数设为 :1560096 用户 k 参数为 :4fe440240e2 3. 服务器通过计算得出 hashvalue tm p_m d5=md5(3456stream1560096)=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=143696000[&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=143696000[&nonce=4e1f2519c626cbfbab1520c25530c26]", fpad: false, capabilities: 994.5, audiocodecs: 3191, videocodecs: 252, videofunction: 1, pageurl: null, objectencoding: 3.0 金山云 4/20
操作指南 2019--26 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 2009 22:32:00 GMT 成功响应示例 HTTP/1.1 200 OK Content-Length: length Content-Type: text/plain Date:Wed, 2 Oct 2009 22: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/1.1 403 Forbidden Content-Length: length Content-Type: text/plain Date: Wed, 2 Oct 2009 22: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/1.1 403 Forbidden Content-Length: length Content-Type: text/plain Date: Wed, 2 Oct 2009 22:32:00 GMT Server: Nginx <?xml version="1.0" encoding="utf-"?> <Error> <Code>NonExistApplication</Code> </Error> 3. 流不存在 HTTP/1.1 403 Forbidden Content-Length: length Content-Type: text/plain Date: Wed, 2 Oct 2009 22:32:00 GMT Server: Nginx <?xml version="1.0" encoding="utf-"?> <Error><Code>NonExistStreamName</Code> </Error> 返回错误 Erro r Descriptio n 金山云 5/20
操作指南 2019--26 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 2009 22:32:00 GMT 错误响应示例 HTTP/1.1 200 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 毫秒时间戳 145600010000 NotifyType String 回调类型,PubStart: 推流开始,PubEnd: 推流结束 PubStart PubParam Object 推流携带的参数 金山云 6/20
操作指南 2019--26 ClientIp String 推流端 IP ClientPort Int 推流端端口 Node String cdn 接受流的节点 开播回调示例 "Version":"1.0", "App":"live", "Pubdomain":"xxx.xxx.com", "Stream":"test", "PubStartUnixTime":"145600010000", "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 毫秒时间戳 145600010000 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":"145600010000", "NotifyType":"PubEnd", "ClientIp":" ", "ClientPort":" ", "Node":" ", "PubEndMessage":" ", "PubParam": "param1":"3456", "param2": 延时直播 延时直播 产品介绍 简单地说, 延时直播就是节目播出的时间, 要比直播推流开始的时间有一定的延迟 延时的目的是为监播人员提供一定的监播时间, 以防止不利于社会稳定和安全的画面及语言播出 国家广电总局规定, 有群众参与的电视节目必须延时播出 20 秒以上 延时直播绝非录播 录播是指播出前把整档节目按播出要求编辑录制, 做成完整节目的播出带, 按规定播出时间进行播放的方式 应用场景 为保障播出内容审核无误, 向直播监播人员提供一定的监播时间, 提前发现不利于社会稳定和安全的画面及语言, 及时阻断直播内容播出 产品优势 充分延时时长 金山云延时直播支持 1min-5min 的延时时间, 预留出充足的时间供监控人员对直播内容进行审核, 保证播出内容安全健康 延时直播二期将支持延时时长 1min-30min, 敬请期待 源流供监控 源流顾名思义就是没有进行延时处理的直播流, 可提供到监控人员进行播出前内容审核, 保障播出内容安全 延播流供观看 延播流顾名思义就是进行了延时处理的直播流, 可将审核过的安全直播内容分发给观众观看 ; 亦可对此路流开启录像生成回看 秒级禁播 提供禁播接口, 若监控人员发现不利于社会稳定和安全的画面及语言, 可及时将源流或者延播流阻断, 防止不健康内容播出 开通说明 此内容正在更新中, 请咨询商务人员 直播录像 HLS 录像 MP4 录像 FLV 录像 录像回调 概念解释 开通流程 直播录像服务是将直播原始流经过音视频转封装格式 ( 不修改编码方式 音视频数据以及对应的时间戳等信息 ) 得到的录制文件存储到 KS3 的服务 金山云 /20
操作指南 2019--26 说明 直播录像服务需要在直播控制台开通并配置存储 bucket 和回调 url, 所以需要同时开通金山云存储 KS3 服务, 具体请咨询商务人员帮助您开通 直播录像存储目前仅支持北京 region 直播录像是对音视频封装格式的转换, 不修改编码参数, 因此当同一个录制文件前后编码参数不一致时, 可能导致 MP4 FLV 录制文件异常 当相同流名前后推流编码参数不一致时建议关闭拼接功能, 若有拼接需求可通过媒体处理解决 若开通 MP4/FLV 录像功能, 必须先开启 HLS 录像金山云录制默认开启自动拼接功能, 同流名的文件会拼接为一个录制文件 推流 URL 携带 vdoid 参数示例 rtmp://uniquename.uplive.ks-cdn.com/live/stream?vdoid=14402932 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_2019-01-25-16-52-06_2019-01-25-1-30-33.m3u 方式 3( 需联系技术支持配置 ) 录像生成规则 : 同流名 5min( 可配 ) 内断流重推录像进行拼接, 录像总时长超过 4h( 可配 ) 进行切割 ; 路径 :/record/app/stream/hls/ 命名 :[ 流名 ]-[ 年月日 ]-[ 时分秒 ]-[unix 毫秒时间戳末三位 ]-[ 切割后缀 ].m3u 示例 : stream-20060102-150405-16-0.m3u ( 切割第一段 ) stream-20060102-150405-16-1.m3u ( 切割第二段 ) stream-20060102-150405-16-2.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_2019-01-25-16-52-06_2019-01-25-1-30-33.mp4 方式 3( 需联系技术支持配置 ) 录像生成规则 : 同流名 5min( 可配 ) 内断流重推录像进行拼接, 录像总时长超过 4h( 可配 ) 进行切割 路径 :/record/app/stream/mp4/ 命名 :[ 流名 ]-[ 年月日 ]-[ 时分秒 ]-[unix 毫秒时间戳末三位 ]-[ 切割后缀 ].mp4 金山云 /20
操作指南 2019--26 示例 : stream-20060102-150405-16-0.mp4 ( 切割第一段 ) stream-20060102-150405-16-1.mp4( 切割第二段 ) stream-20060102-150405-16-2.mp4 ( 切割第三段 ) [ 年月日 ]-[ 时分秒 ]-[unix 毫秒时间戳末三位 ]: 为最初推流开始时间 FLV 录像 过期存储 : 文件保存时间可以自定义修改, 在 KS3 平台做操即可 方式 1( 默认 ) 录像生成规则 : 同流名 5min( 可配 ) 内断流重推录像进行拼接, 录像总时长超过 4h( 可配 ) 进行切割 ; 路径 :/record/app/stream/flv/ 命名 :[ 流名 ]-[ 年月日 ]-[ 时分秒 ]-[unix 毫秒时间戳末三位 ]-[ 切割后缀 ].flv 示例 : stream-20060102-150405-16-0.flv( 切割第一段 ) stream-20060102-150405-16-1.flv( 切割第二段 ) stream-20060102-150405-16-2.flv ( 切割第三段 ) [ 年月日 ]-[ 时分秒 ]-[unix 毫秒时间戳末三位 ]: 为最初推流开始时间 过期存储 : 录像支持 60 天过期存储, 即过期时间为 60 天 方式 2( 推荐, 需联系技术支持配置 ) 录像生成规则 : 同流名 5min( 可配, 默认 10h) 内断流重推对录像文件进行拼接, 录像总时长超过 4h( 可配, 默认关闭 ) 进行切割 ; 路径 :/record/app/stream/flv/ 命名 :[ 流名 ]-[ 文件开始时间 ]-[ 文件结束时间 ].flv 示例 : stream_2019-01-25-16-52-06_2019-01-25-1-30-33.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":"145600010", "endtime":"145600020", "streamid":"xxxx", "throughparams":"xxxx", "items":[ "dstpath":"xxxxx.mp4", "ETag":"cb1b99f665c91dac6c19cd991a1", "outmediainfo":""metadata":,"format":"format_name":"mp4","size":102254935,"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
操作指南 2019--26 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":"0099695aa9fc", "itmes":[ "cmd":"", "desc":"success", "keys":[ "record/app/stream/hls/stream-201-0052-14-0.m3u", "record/app/stream/hls/stream-201-0052-14-1.m3u", "record/app/stream/hls/stream-201-0052-14-2.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
操作指南 2019--26 命名规则 :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/v14555042426/xxx.jpg" ], "code": 3 ], "type" : "LiveSnapShotCallBack", // 标识该调用类型 "details" : "errnum" : 0, // 错误码 "errmsg" : "", // 错误码, 非必选 "uniqname" : "myuniqname", // 用户标识 "stream_name" : "345", // 流名 "timestamp" : 14646545, // 截图产生的时间点 "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/v14555042426/xxx.jpg 截图路径 code 3 执行返回的代码 type LiveSnapShotCallBack 标识该调用类型 errnum 0 错误码 errmsg xxx 错误 uniqname myuniqname 域名标识 stream_name 3 流名 timestamp 14646545 截图产生的时间点 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
操作指南 2019--26 产品架构 产品功能 编码算法和分辨率 支持 H.264,H.265;2K,4K,20P,100P 等 多种格式 支持全部主流封装格式和编码格式 配额机制 用户根据 CPU 核数或并发路数设置配额参数 转码操作 将不同媒体格式的文件以不同的分辨率 比特率和帧速等设定转换成 HLS/MP4 文件的计算工作 自定义模板 用户通过模板中参数类型自定义符合要求模板类型 截图 支持对 KS3 上的视频进行截图, 并根据时间点生成单张图片或者根据采样点生成多长采样截图 水印 可以将 KS3 上的 png 水印图片根据用户设定位置覆盖到视频中, 并支持水印图片的自动缩放 截取 根据指定起始时间点, 截取指定时长的媒体文件 视频信息提取 提取 KS3 上视频文件参数信息 监控机制 提供全面任务查询机制和任务结束回调机制 语言 SD K 提供 PHP java 和 python 语言 SDK 接入服务 金睛服务 金睛服务 产品概述 产品功能 产品优势 解决方案 金睛控制台使用手册 金山云 /20
操作指南 2019--26 计费模式和开通说明 产品概述 金睛 (KingIntelligentEyes) 是金山云针对淫秽色情 暴恐 群体性事件等网络视频内容人工监管困难的现状, 为净化网络环境, 给客户提供的视频内容安全智能监管解决方案 金山云基于深度学习图片识别技术, 高效准确地对视频内容进行色情 暴恐 群体性事件的识别, 提高客户审核效率, 解决审核成本 金山视频云内容安全智能审核平台 金睛 提供一站式视频内容安全解决方案, 提供图形化审核控制台和完善的开放接口, 客户可根据现状自主组合定制内容安全解决方案 产品功能 智能识别 支持识别直播内容中色情, 性感, 暴恐, 群体性事件四种不良信息, 可选择分别开启或关闭, 可根据客户自身的直播场景配置识别的阈值, 阈值范围为 0-100%, 阈值设置越大识别到的截图越接近以上四种类型 智能鉴黄 : 高效准确地识别直播视频的色情 / 性感内容, 准确率高达 99% ; 暴恐识别 : 高效准确地识别直播视频的暴恐内容, 准确率高达 99% ; 群体性事件识别 : 高效准确地识别直播视频的群体性事件内容, 准确率高达 99% ; 一键断流 客户发现直播流含不良信息后, 可通过在金睛控制台上直接一键断流操作或者调用断流接口将直播流拉入黑名单, 若监控人员不小心误操作, 也支持一键恢复直播流的推送 实时报警 在金睛控制台上若智能识别到监控墙上某路流含不良信息, 此路流会闪红报警, 提醒人工审核人员重点关注 信息推送 客户可设置回调 URL, 实时通知智能监控预警信息 截图存档 对人工监控进行断流操作时的截图和机器识别到不良信息的截图进行存档取证 权限管理 金睛控制台使用主账号和 IAM 用户来区分管理员和监控员的权限, 主账号拥有金睛控制台管理权限, 可以查看并操作云直播控制台上包含金睛控制台在内的任何操作,IAM 用户拥有金睛控制台监控权限, 只能查看分级预警, 直播 / 截图监控墙, 监控收录和阻断 / 恢复单路流推送操作 产品优势 优势 详情 无缝对接 易接入, 开通内容安全平台, 快速生成直播监控墙 灵活应用 完善的底层接口, 客户可根据现状自主组合定制内容安全解决方案 解放人力 机器协助监控, 识别准确率高, 有效解放审核人力 高效处理 即时发现不良信息即时报警回调信息, 审核人员高效处理 权限管理 平台登录人员区分权限, 监控人员只可对监控直播流操作, 管理员可设置阈值等配置操作 监控内容全覆盖对涉及淫秽色情, 暴恐, 群体性事件等各种不良信息的直播内容进行全方位覆盖监控 金山云直播内容安全解决方案 方案介绍 金山云金睛解决方案, 主要解决直播行业的色情直播 暴恐识别 群体性事件识别等问题 解决方案涵盖 PaaS 和 SaaS 一站式服务, 用户可以根据自身需求定制适应自身的安全解决方案, 也可用使用金山金睛 SaaS 平台, 立刻启动人工监控 方案特色 特色 详情 监控墙 金睛平台一站式解决方案, 直接对接金山云直播控制台生成直播监控墙, 开启人工审核 一键断流 对含有不良信息的直播视频可进行一键断流 监控内容全面覆盖对涉及淫秽色情, 暴恐, 群体性事件等各种不良信息的直播内容进行全方位覆盖监控 自定义监控阈值 客户可根据自身直播场景对色情, 暴恐, 群体监控自定义设置报警阈值 收录存档 对报警截图和断流截图进行存档留证 金睛控制台使用手册 客户开通金睛服务之后, 云直播控制台上可见内容安全模块 ( 申请开通金睛平台的前提是客户已开通金山云视视频云服务 ), 使用金山云主账号登录云直播控制台, 可以查看和操作云直播控制台上的任何模块, 在此重点介绍内容安全的分级预警 直播监控墙 截图监控墙 监控收录和监控配置模块 : 内容安全 1. 分级预警 分级预警页面包含最新预警最新预警和预警分布预警分布 ( 最近一小时 ) 的数据展示, 如图 金山云 /20
操作指南 2019--26 1.1 最新预警 最新预警部分记录的是最新智能识别到的含色情 / 性感 / 暴恐 / 群体信息的流的相关信息 : 威胁程度, 流名, 类型, 更新日期, 截图, 操作 最新预警 说明 威胁程度 分为高威胁 ( 色情 暴恐 ) 和低威胁 ( 性感 群体 ) 流名 每个流名只显示一条记录, 例如流 stream1 的两张截图均检测到色情, 只显示最新记录, 可查看最新的截图 类型 识别预警的截图类型, 支持色情 性感 暴恐和群体性事件的识别, 具体识别预警类型客户可自定义配置 更新日期 此路流最新识别到不良信息截图的时间 截图 此路流最新预警的截图 操作 可对预警流进行断流或者恢复的操作, 断流 : 将此路流拉入黑名单, 恢复 : 将此路流拉出黑名单 1.2 预警分布 ( 最新一小时 ) 使用饼图和柱状图展示最新一小时预警截图在各种识别类型上的分布情况 2. 直播监控墙 直播监控墙用于展示客户实时直播流, 可适应不同屏幕选择每一页的直播流展示数量 (/24/36), 方便人工审核人员在不同屏幕上进行实时监控和根据人力分配直播流监控数, 可根据流名查询某路流的直播内容, 如图 金山云 14/20
操作指南 2019--26 注意 : 直播监控墙现只支持 rtmp 播放格式, 会产生相应 CDN 费用 监控详情页 点击直播流上任意空白处可进入监控详情页, 查看色情 性感 暴恐和群体的智能识别截图结果, 如图 3. 截图监控墙 截图监控墙用于展示客户实时直播流, 可适应不同屏幕选择每一页的直播流展示数量 (/24/36), 方便人工审核人员在不同屏幕上进行实时监控和根据人力分配直播流监控数, 可根据流名查询某路流的直播内容, 点击截图的任意空白处也可进入监控详情页, 截图监控墙如图 : 金山云 15/20
操作指南 2019--26 4. 监控收录 监控收录展示收录的智能预警截图和断流存档截图信息, 支持不同时间段 不同类型 不同流名查询 4.1 智能截图 智能截图里收录了智能检测预警的所有截图信息, 如图 : 金山云 16/20
操作指南 2019--26 智能截图 说明 创建时间 本张截图的创建时间 文件名称 截图的文件名称, 点击可查看截图内容 流名 本张截图的所属流名 类型 / 匹配度类型 : 识别预警的截图类型, 支持色情 性感 暴恐和群体性事件的识别, 具体识别预警类型客户可自定义配置 匹配度 : 识别类型的匹配度 操作 可对截图进行删除操作 4.2 断流截图 断流操作时生成的截图存档文件, 注意如果推流开始时间过短就进行断流操作, 可能不会生成截图, 因为截图任务未启动 断流截图 断流时间文件名称流名操作 说明 5. 监控配置 进行断流操作是时间点截图的文件名称, 点击可查看截图内容本张截图的所属流名可对本条流进行断流 / 恢复直播流推动的操作 ; 可删除本条断流记录, 截图文件也一并删除 监控配置页面上可进行监控识别类型 ( 色情 性格 暴恐 群体 ) 阈值 存储空间和通知 URL 的配置, 如图 断流截图 说明 色情识别 可选择开启 / 关闭, 开启即开启了截图的色情和性感的识别, 阈值可分别配置, 阈值范围为 0-100% 暴恐识别 可选择开启或者关闭, 开启即开启截图的暴恐识别, 可设置阈值, 阈值范围为 0-100% 金山云 1/20
操作指南 2019--26 群体性事件识别可选择开启或者关闭, 开启即开启截图的群体性事件识别, 可设置阈值, 阈值范围为 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. 在 用户管理 列表页面, 点击 新建 按钮, 进入 创建用户 对话框, 如下图 输入用户名和姓名后, 点击 确定 按钮, 完成 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
操作指南 2019--26 4. 列表项包括 : 用户名 姓名 密码状态 ( 是否已设置 ) 访问密钥状态 用户创建时间 操作列表 查看 IA M 用户详情 能够查看当前主账户下的 IAM 用户的详细信息, 操作如下 : 1. 使用主账户或者已授权的 IAM 用户身份登录控制台 ( 新版 ) 2. 选择 身份与管理 一级菜单 -> 选择 身份与访问控制 二级菜单 -> 选择 用户管理 三级菜单 3. 在 用户管理 列表页面, 点击 IAM 用户名, 进入 用户详情 页面, 如下图 4. 页面上部显示 IAM 用户基本信息和操作按钮, 其中基本信息包括 : 用户名 姓名 密码状态 创建时间 KRN 和路径 ; 页面下部显示用户附加策略 tab 页和用户访问密钥 tab 页 修改用户姓名 能够修改某 IAM 用户的姓名, 操作如下 : 1. 使用主账户或者已授权的 IAM 用户身份登录控制台 ( 新版 ) 2. 选择 身份与管理 一级菜单 -> 选择 身份与访问控制 二级菜单 -> 选择 用户管理 三级菜单 3. 在 用户管理 列表页面, 点击某 IAM 用户的 姓名 旁边的小图标 ( 鼠标划过显现 ), 或者进入 用户详情 页面点击 修改姓名 按钮, 都可以对 IAM 用户的姓名进行修改 注 : 修改 IAM 用户的姓名不影响任何策略授权结果, 而 IAM 用户名不允许修改 计费模式和开通说明 金睛收费 此内容正在更新中, 请咨询商务人员 金睛服务开通方式 此内容正在更新中, 请咨询商务人员 金山云 20/20