高级分析–根据观众id查询观众分析结果

接口URL

http://api.polyv.net/v2/advance/viewer/{userid}

接口说明

高级分析--根据观众id查询观众分析结果

支持格式

JSON

请求方式

GET

请求参数

参数名 必选 类型及范围 说明
ptime true string 当前时间的毫秒级时间戳(13位),30分钟内有效
sign true string 签名
userid true string 用户id(拼接在url,无需另外传参数)
viewerId true string 观众id

注意事项

所有有值的参数,按照字母排序方式以key=value&key=value的格式串起来,最后拼上secretkey,以SHA-1方式加密并全部大写化。(注意,当参数没有传递,或者传递了空值,sign不需要将此参数计算进去)

例如:api传递了ptime,vid。ptime为1,vid为test1,userid对应用户的secretkey为test2
则sign的值为:ptime=1&vid=test1test2经过SHA-1加密后大写化为: C2B1558D697EA3AF4ED2FC90152751860C1E2163。

返回错误结果JSON示例

{
  "code": 400,
  "status": "error",
  "message": "ptime is too old.",
  "data": ""
}

返回正确结果JSON示例

{
  "code": 200,
  "status": "success",
  "message": "success",
  "data": {
    "userId": "xxxx",
    "viewerId": "观众id",
    "viewerNickName": "观众昵称",
    "viewerAatar": null,
    "ip": "127.0.0.1",
    "firstWatchTime": 1547020140000,
    "lastWatchTime": 1548148547000,
    "totalVideoCount": 6,
    "totalWatchDuration": 1870,
    "avgCompletionRate": 0.519
  }
}

返回结果data表示成功修改的数量.

字段说明

字段 说明
code 返回码
status 返回状态
message 返回信息
data 操作结果

数据对象字段说明

字段 说明
userId 用户id
viewerId 观众id
viewerNickName 观众昵称
viewerAatar 观众头像
ip ip地址
firstWatchTime 首次观看时间
lastWatchTime 最后观看时间
totalVideoCount 观看视频总数
totalWatchDuration 观众总时长(秒)
avgCompletionRate 平均观看完成度

响应代码与响应信息对应

code message data 说明
400 sign can not be empty. 加密串为空
400 ptime is too old. 时间戳过期
400 ptime is illegal. ptime超出当前时间3分钟
400 Could not find user by userid. userid不存在
400 the sign is not right. 加密串错误
401 viewerId is blank. viewerId为空
402 cannot find the viewer analytics data. 查不到对应的观众分析数据
403 get viewer analytics failed. 查询观众分析数据失败
500 get viewer analytics failed. please check the backend log 后台抛异常
200 success 查询到的数据 查询成功

PHP示例代码

<?php
header("Content-type: text/html; charset=utf-8");
$userid="3828390191";
//$jsonp="a";
$ptime=time()*1000;//13位
$viewerId="观众id";
$secretkey="secretkey";
if(empty($jsonp)){
  $str="ptime=".$ptime."&viewerId=".$viewerId.$secretkey;
}else{
  $str="jsonp=".$jsonp."&ptime=".$ptime."&viewerId=".$viewerId.$secretkey;
}
echo $str.'';
$hash=strtoupper(sha1($str));
echo $hash.'';
$url="http://api.polyv.net/v2/advance/viewer/{$userid}?viewerId={$viewerId}&ptime={$ptime}&sign={$hash}";
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);

$output = curl_exec($ch);
curl_close($ch);
//打印获得的数据
print_r($output);
?>

签名规则:

将非空的请求参数按照参数名字典顺序排列,连接参数名与参数值,并在尾部加上secretkey,生成40位大写SHA1值,作为sign。 以下是示例过程:

1、请求参数为

"ptime" = "1493188350000"
"playauth" = "1"

2、将请求参数按照参数名字典顺序排列

"playauth" = "1"
"ptime" = "1493188350000"

3、连接字符串
连接参数名与参数值,并在尾部加上secretkey(secretkey的值为tIQp4ATe9Z),如下:

playauth=1&ptime=1493188350000tIQp4ATe9Z

4、生成签名sign

7198CB4BAE7484C01EA1A1566D0210FF18EA1849
以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...

高级分析–根据视频id查询视频分析数据

接口URL

http://api.polyv.net/v2/advance/video/{userid}

接口说明

高级分析--根据视频id查询视频分析结果

支持格式

JSON

请求方式

GET

请求参数

参数名 必选 类型及范围 说明
ptime true string 当前时间的毫秒级时间戳(13位),30分钟内有效
sign true string 签名
userid true string 用户id(拼接在url,无需另外传参数)
vid true string 视频id

注意事项

所有有值的参数,按照字母排序方式以key=value&key=value的格式串起来,最后拼上secretkey,以SHA-1方式加密并全部大写化。(注意,当参数没有传递,或者传递了空值,sign不需要将此参数计算进去)

例如:api传递了ptime,vid。ptime为1,vid为test1,userid对应用户的secretkey为test2
则sign的值为:ptime=1&vid=test1test2经过SHA-1加密后大写化为: C2B1558D697EA3AF4ED2FC90152751860C1E2163。

返回错误结果JSON示例

{
  "code": 400,
  "status": "error",
  "message": "ptime is too old.",
  "data": ""
}

返回正确结果JSON示例

{
  "code": 200,
  "status": "success",
  "message": "success",
  "data": {
    "videoId": "xxxxxxxxxxxxxxxx",
    "videoName": "视频名称m",
    "duration": 100,
    "playTimes": 665,
    "uniqueViewerCount": 614,
    "avgCompletionRate": 0.49,
    "viewHeatmap": "[\"0-20:662\",\"21-100:665\"]",
    "uniqueViewHeatmap": "[\"0-20:614\",\"21-100:615\"]"
  }
}

返回结果data表示成功修改的数量.

字段说明

字段 说明
code 返回码
status 返回状态
message 返回信息
data 操作结果

数据对象字段说明

字段 说明
videoId 视频id
videoName 视频名称
duration 视频时长
playTimes 播放次数
uniqueViewerCount 唯一观众数
avgCompletionRate 平均观看完成度
viewHeatmap 观看热力图,例如[\"0-20:662\",\"21-100:665\"]代表视频内容的0~20秒有662次观看,21~100秒有665次观看
uniqueViewHeatmap 唯一观看热力图,例如[\"0-20:614\",\"21-100:615\"]代表视频内容的0~20秒有614个观众观看,21~100秒有615个观众观看

响应代码与响应信息对应

code message data 说明
400 sign can not be empty. 加密串为空
400 ptime is too old. 时间戳过期
400 ptime is illegal. ptime超出当前时间3分钟
400 Could not find user by userid. userid不存在
400 the sign is not right. 加密串错误
401 vid is blank. 视频id为空
402/403 cannot find this video data. 查不到视频分析数据
404 get video analytics detail failed. 后台获取数据失败
500 get play list failed. please check the backend log. 后台抛异常
200 success 查询到的数据 查询成功

PHP示例代码

<?php
header("Content-type: text/html; charset=utf-8");
$userid="3828390191";
//$jsonp="a";
$ptime=time()*1000;//13位
$vid="视频id";
$secretkey="secretkey";
if(empty($jsonp)){
  $str="ptime=".$ptime."&vid=".$vid.$secretkey;
}else{
  $str="jsonp=".$jsonp."&ptime=".$ptime."&vid=".$vid.$secretkey;
}
echo $str.'';
$hash=strtoupper(sha1($str));
echo $hash.'';
$url="http://api.polyv.net/v2/advance/video/{$userid}?vid={$vid}&ptime={$ptime}&sign={$hash}";
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);

$output = curl_exec($ch);
curl_close($ch);
//打印获得的数据
print_r($output);
?>

签名规则:

将非空的请求参数按照参数名字典顺序排列,连接参数名与参数值,并在尾部加上secretkey,生成40位大写SHA1值,作为sign。 以下是示例过程:

1、请求参数为

"ptime" = "1493188350000"
"playauth" = "1"

2、将请求参数按照参数名字典顺序排列

"playauth" = "1"
"ptime" = "1493188350000"

3、连接字符串
连接参数名与参数值,并在尾部加上secretkey(secretkey的值为tIQp4ATe9Z),如下:

playauth=1&ptime=1493188350000tIQp4ATe9Z

4、生成签名sign

7198CB4BAE7484C01EA1A1566D0210FF18EA1849
以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...

高级分析-分页查询观看行为列表

接口URL

http://api.polyv.net/v2/advance/play/{userid}

接口说明

高级分析--根据条件分页查询观看行为列表

支持格式

JSON

请求方式

GET

请求参数

参数名 必选 类型及范围 说明
ptime true string 当前时间的毫秒级时间戳(13位),30分钟内有效
sign true string 签名
userid true string 用户id(拼接在url,无需另外传参数)
start false string 开始时间,格式为yyyy-MM-dd或者yyyy-MM-dd HH:mm:ss,查询范围不超过31天
end false string 结束时间,格式为yyyy-MM-dd或者yyyy-MM-dd HH:mm:ss,查询范围不超过31天
pageSize false int 每页取多少条数据(最大为20,超过则默认取20条数据)
viewerId false string 观众id
viewerName false string 观众昵称
vid false string 视频id
token false string 下一页的凭证,从当前页的返回数据里获取,第一页不需要传

时间参数说明

  • 查询的时间跨度不超过31天;
  • 当start有值而end为空时,返回开始日期后31天后的数据;
  • 当start为空而end不为空时,返回结束日期前31天内的数据;
  • 当start、end参数均为空时,返回最近31天的数据。

注意事项

所有有值的参数,按照字母排序方式以key=value&key=value的格式串起来,最后拼上secretkey,以SHA-1方式加密并全部大写化。(注意,当参数没有传递,或者传递了空值,sign不需要将此参数计算进去)

例如:api传递了ptime,vid。ptime为1,vid为test1,userid对应用户的secretkey为test2
则sign的值为:ptime=1&vid=test1test2经过SHA-1加密后大写化为: C2B1558D697EA3AF4ED2FC90152751860C1E2163。

返回错误结果JSON示例

{
  "code": 400,
  "status": "error",
  "message": "ptime is too old.",
  "data": ""
}

返回正确结果JSON示例

{
  "code": 200,
  "status": "success",
  "message": "success",
  "data": {
    "pageSize": 3,
    "contents": [
      {
        "startTime": "2019-10-01 11:12:05",
        "videoId": "xxxxxx",
        "videoName": "test video",
        "videoImage": "//img.videocc.net/uimage/xxxxxx.jpg",
        "videoDuration": 100,
        "deviceClass": "Phone",
        "osName": "Android",
        "osVersion": "Unknown",
        "agentName": "Unknown",
        "agentVersion": "Unknown",
        "referer": "N/A",
        "ip": "127.0.0.1",
        "country": "中国",
        "province": "广东",
        "city": "未知",
        "isp": "中国电信",
        "viewerId": "1234567890",
        "viewerNickName": "N/A",
        "viewerAvatar": "N/A",
        "totalVideoCount": 100,
        "heatmap": "[\"0-1:1\",\"2-3:1\"]",
        "completionRate": 0.02,
        "status": 61
      },
      {
        "startTime": "2019-10-01 11:12:05",
        "videoId": "xxxxxx",
        "videoName": "test video",
        "videoImage": "//img.videocc.net/uimage/xxxxxx.jpg",
        "videoDuration": 100,
        "deviceClass": "Phone",
        "osName": "Android",
        "osVersion": "Unknown",
        "agentName": "Unknown",
        "agentVersion": "Unknown",
        "referer": "N/A",
        "ip": "127.0.0.1",
        "country": "中国",
        "province": "广东",
        "city": "未知",
        "isp": "中国电信",
        "viewerId": "1234567890",
        "viewerNickName": "N/A",
        "viewerAvatar": "N/A",
        "totalVideoCount": 100,
        "heatmap": "[\"0-50:1\"]",
        "completionRate": 0.5,
        "status": 61
      },
      {
        "startTime": "2019-10-01 11:12:05",
        "videoId": "xxxxxx",
        "videoName": "test video",
        "videoImage": "//img.videocc.net/uimage/xxxxxx.jpg",
        "videoDuration": 100,
        "deviceClass": "Phone",
        "osName": "Android",
        "osVersion": "Unknown",
        "agentName": "Unknown",
        "agentVersion": "Unknown",
        "referer": "N/A",
        "ip": "127.0.0.1",
        "country": "中国",
        "province": "广东",
        "city": "未知",
        "isp": "中国电信",
        "viewerId": "1234567890",
        "viewerNickName": "N/A",
        "viewerAvatar": "N/A",
        "totalVideoCount": 100,
        "heatmap": "[\"0-50:1\"]",
        "completionRate": 0.5,
        "status": 61
      }
    ],
    "token": "xxxxxxxxxxxxxxx",
    "hasNextPage": true
  }
}

返回结果data表示成功修改的数量.

字段说明

字段 说明
code 返回码
status 返回状态
message 返回信息
data 操作结果

数据对象字段说明

字段 说明
startTime 首次观看日期
videoId 视频id
videoName 视频名称
videoImage 视频首图(没有添加协议头)
videoDuration 视频时长
deviceClass 设备名称
osName 操作系统
agentName 终端名称
agentVersion 终端版本
referer 来源
ip ip地址
country 国家
province 省份
city 地区
isp 运营商
viewerid 观众id
viewerNickName 观众昵称
viewerAvatar 观众头像
totalVideoCount 观众看的视频总量
heatmap 热力图(["0-1:1","3-4:2"]表示视频的0到1秒有1次观看,3到4秒有2次观看)
completionRate 观看完成度
status 视频的状态
token 查询下一页时传的凭证
hasNextPagetoken 是否有下一页

响应代码与响应信息对应

code message data 说明
400 sign can not be empty. 加密串为空
400 ptime is too old. 时间戳过期
400 ptime is illegal. ptime超出当前时间3分钟
400 Could not find user by userid. userid不存在
400 the sign is not right. 加密串错误
401 start date or end date is illegal. start或者end参数格式有问题
402 date range exceeds 31 days. start和end参数相差超过31天
403 get play list error. 后台获取数据失败
500 get play list failed. please check the backend log. 后台抛异常
200 success 查询到的数据 查询成功

PHP示例代码

<?php
header("Content-type: text/html; charset=utf-8");
$userid="3828390191";
//$jsonp="a";
$ptime=time()*1000;//13位
$start="2019-10-15";
$secretkey="tIQp4ATe9Z";
if(empty($jsonp)){
  $str="start=".$start."&ptime=".$ptime.$secretkey;
}else{
  $str="jsonp=".$jsonp."&start=".$start."&ptime=".$ptime.$secretkey;
}
echo $str.'';
$hash=strtoupper(sha1($str));
echo $hash.'';
$url="http://api.polyv.net/v2/advance/play/{$userid}?start={$start}&ptime={$ptime}&sign={$hash}";
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);

$output = curl_exec($ch);
curl_close($ch);
//打印获得的数据
print_r($output);
?>

签名规则:

将非空的请求参数按照参数名字典顺序排列,连接参数名与参数值,并在尾部加上secretkey,生成40位大写SHA1值,作为sign。 以下是示例过程:

1、请求参数为

"ptime" = "1493188350000"
"playauth" = "1"

2、将请求参数按照参数名字典顺序排列

"playauth" = "1"
"ptime" = "1493188350000"

3、连接字符串
连接参数名与参数值,并在尾部加上secretkey(secretkey的值为tIQp4ATe9Z),如下:

playauth=1&ptime=1493188350000tIQp4ATe9Z

4、生成签名sign

7198CB4BAE7484C01EA1A1566D0210FF18EA1849
以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...

视频高级分析

一、观看行为分析

观看行为分析,基于Polyv大数据分析,能够以秒为粒度展示观众如何观看您的视频。
视频观看热力图是单次观看行为的图形化表示,Polyv云点播视频的每一次播放,都会产生一个热力图。这是一种强大的工具,因为热力图不仅展示了观看完成度这样的统计结果,还直观地还原了整个观看过程,它可以帮助您更全面、深度地了解您的观众以及他们对视频内容的不同喜好,从而挖掘出更大的数据价值,帮助业务运营更好地开展。

热力图示例:

heatmap

视频观看热力图包含观众信息、设备环境相关信息(视频播放的时间、地点、播放设备等)以及基于时间线的不同颜色区块。

热力图最左边的时间表示视频开始播放的时间。

接下来是观众信息,包含观众头像、该观众观看您账号下视频的总数量、观众昵称以及观看地点。点击头像或昵称可以跳转至观众分析页面。

注:热力图中能够显示观众头像和昵称的前提是把观众信息传给播放器(详见设置观众信息)。如果没有传头像信息,则头像会以蓝色方块来代替;如果没有传昵称,则昵称会以观众ID来代替;如果观众ID也没有的话,则头像以灰色方块代替,昵称统一为“游客”。

点击观众昵称右边的展开按钮,可查看更多信息,包括:

  • 观看设备信息:设备类型(包含桌面电脑和移动设备)、操作系统、浏览器类型;
  • 观看IP和网络运营商信息;
  • 观看页面的URL

视频信息包含视频封面图、视频名称、视频时长以及视频ID。

观看热力图,通过基于时间线的不同颜色区块来表示观众观看视频的过程,颜色越“热”,代表重复观看的次数越多,这可能意味着观众对这部分视频内容更感兴趣。

  • 白色区块表示观众跳过了这一部分视频内容,没有观看;
  • 绿色区块表示观众正常观看了这一部分视频内容;
  • 黄色区块表示这部分视频内容被重复观看了两次;
  • 橙色、红色以及深红色分别表示视频内容被重复观看了三次、四次以及四次以上。

二、视频分析

热力图展示了单个观众如何观看您的视频,而视频分析图表可让您了解整个观众群体是如何观看视频的。
videoAnalysis

红色折线表示对应时间点的视频内容被观看的次数。
蓝色折线表示观看过对应时间点视频内容的观众人数。
所以视频分析图表中的蓝色区域表示所有观众的整体参与度,红色区域表示那部分视频内容被重复观看的次数。在图表上移动鼠标可查看视频每一帧的画面以及对应的观看统计信息(观众数、观众参与度以及重复观看次数)。

通过视频分析图表,您可以查看视频的哪些部分被观众多次重复观看,哪些部分没有被观看。比如图表中的折线出现跌落可能意味着这部分视频内容观众不再感兴趣,而上升则可能意味着这部分视频内容吸引了观众的注意力。所有的这些信息可以帮助您优化视频内容,为今后制作更有吸引力的视频内容提供指导。

图表左侧是视频整体播放数据的几个重要指标统计,让您从宏观层面了解迄今为止该视频的播放情况。其中平均完成度的计算公式为:平均完成度 = 视频实际播放的总时长 / (总播放次数 x 视频时长)。平均完成度表示平均每个人观看时长占视频总时长的百分比,完成度越高说明观众对视频越感兴趣。

注:平均完成度指标在不同类型的视频上应使用不同的考量标准。根据经验,帮助中心视频的平均完成度在50%左右,因为人们获取到需要的信息后就会离开了;而官网首页的产品介绍视频,完成度在70%以上才算是一个健康的数值;如果发现有几个视频的完成度非常高,那么我们一定要分析原因并利用这一点做出对应的行动。

三、观众分析

您的观众并不只代表了用户数这一个整体指标,他们还是独立的个体,您可以通过观众分析来更全面地了解您的每一个用户。
audience-list

在观众列表中,您可以查看每个观众观看您视频的总数,以及首次观看的时间。
audience-detail
每个观众都有独立的一个页面,通过这个页面您可以快速查看该观众的总体统计情况,包括:

  • 观看视频的总数
  • 观看视频花费的总时长
  • 平均观看完成度
  • 首次观看日期

而该观众的视频观看热力图,能够让您洞悉观众的每一次观看过程,帮您更了解您的观众。

以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...

合并字幕文件

接口URL

https://api.polyv.net/v2/video/${userId}/srt/merge

接口说明

接口用于合并字幕文件

支持格式

JSON

请求方式

GET

请求参数

参数名 必选 类型及范围 说明
userid true string 用户id,路径参数
ptime true string 当前13位毫秒级时间戳,3分钟内有效
sign true string 签名,40位大写的sha1值
vid true string 点播视频id
sourceSrtNames true string 原始字幕名称,必须传两个值。以英文逗号分隔,合并后第一个字幕的内容在上方显示。
mergedSrtName false string 合并字幕的名称,默认:双语。不超过5个中文字符。
setAsDefault false boolean 是否设置为默认显示的字幕。默认值:true。

返回结果

{
    "code": 200,
    "status": "success",
    "message": "success",
    "data": true
}

失败返回json(不带jsonp)

{
  "code": 400,
  "status": "error",
  "message": "ptime is too old.",
  "data": ""
}

响应说明

错误代码 message 说明
400 sign can not be empty. 加密串为空
400 ptime is too old. 时间戳过期
400 ptime is illegal. 时间戳参数格式不对或者超过当前时间3分钟
400 Could not find user by userid. userid不存在
400 the sign is not right. 加密串不正确
400 vid is blank 视频id为空
400 sourceSrtNames is error format 原始字幕名称格式错误,需要2个字幕名称,以英文逗号分隔
400 srt file limit 2 , now has 3 每个视频字幕上限为2个
400 not found srt name %s 原始字幕不存在

PHP请求示例

<?php
header("Content-type: text/html; charset=utf-8");
$userid="用户id";
$secretkey="用户secretKey";
$params = array(
    'ptime' => time()*1000,
    'userid' => $userid,
    'vid' => 'b0f70413249189c1c9a4d771fca3807a_b',
    'sourceSrtNames' => '1,2',
    'mergedSrtName' => '合并3',
    'setAsDefault' => 'true'
);

# 创建排序后的字典
foreach ($params as $key=>$value){
    $arr[$key] = $key;
}
sort($arr);
$str='';
$length=count($arr);
foreach ($arr as $k => $v) {
    $str = $str.$v.'='.$params[$v];
    if($k < $length-1) {
      $str = $str.'&';
    }
}
$hash=strtoupper(sha1($str.$secretkey));

$params['sign']=$hash;
$url="http://api.polyv.net/v2/video/${userid}/srt/merge?".http_build_query($params);
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
$output = curl_exec($ch);
curl_close($ch);
//打印获得的数据
print_r($output);
?>

签名规则:

将非空的请求参数按照参数名字典顺序排列,连接参数名与参数值,并在尾部加上secretkey,生成40位大写SHA1值,作为sign。 以下是示例过程:

1、请求参数为

ptime = "1492591990000"
vid = "382839019131be68715e9455f8d0971a_3"
format = "json"

2、将请求参数按照参数名字典顺序排列

format = "json"
ptime = "1492591990000"
vid = "382839019131be68715e9455f8d0971a_3"

3、连接字符串
连接参数名与参数值,并在尾部加上secretkey(secretkey的值为tIQp4ATe9Z),如下:

format=json&ptime=1492591990000&vid=382839019131be68715e9455f8d0971a_3tIQp4ATe9Z

4、生成签名sign

50BF9B165630A8047EB1D17D95A469CC51FF754E
以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...

视频加密方案VRM 9.0升级说明

一. VRM9.0 加密方案介绍

目前FLASH播放器在中国市场仍占据重要地位,为大部分浏览器所应用,而我们也一直在致力于提升其视频播放的安全性。VRM9.0在原有保利威私有加密方案基础上进一步提升了安全级别,能够更有效地保护您的视频资源,降低被盗用的风险。我们建议所有老用户都升级至VRM9.0以获得更高级别的安全防护。

VRM9.0视频加密方案包含加密转码和解密播放两部分。加密转码采用了保利威自有专利的加密算法,能够最大限度保证视频文件的安全;解密播放部分包括:

  • 业务授权
    用户播放视频时需要先通过业务方的权限校验(例如需要登录, 建议使用HTTPS)。如果业务上允许播放,则通过业务方账号的SecretKey签名访问保利威点播PlaySafe服务,获取播放凭证,并返回给播放器。
  • 获取播放地址
    播放器把播放凭证和视频ID参数传给保利威PlaySafe播放服务,播放器会负责剩下的播放流程:

    • 根据视频ID从视频点播服务获取对应的多格式多清晰度的播放地址。
    • 加密视频获取对应的加密钥匙。
  • 加密播放
    保利威提供的安全的播放器内核,使用加密密钥对视频内容进行解密播放。

解密播放的流程架构图如下:
vrm9

二. 升级指引

步骤一:修改Web页面播放器代码

  1. 需传入PlaySafe Token才能在Flash播放器中播放VRM9.0的视频,建议使用多终端嵌入代码。如果您已经使用PC H5的加密播放(Flash和H5可使用同一个token参数),则无需额外开发。
  2. PlaySafe Token的获取代码请参考:创建 Playsafe Token
  3. PlaySafe Token传值方式:
    • 方式一:'playsafe': 'token值'
    • 方式二:'flashvars':{'playsafe':'token值' }
    • 方式三:'playsafeUrl' : '业务方服务端获取token的接口,每次需要token时播放器会请求这个接口获取'
<script src='//player.polyv.net/script/polyvplayer.min.js'></script>
<div id='plv_f13e99573599a939011b2d590abc95b9_f'></div>
<script>
var player = polyvObject('#plv_f13e99573599a939011b2d590abc95b9_f').videoPlayer({
    'width':'970',
    'height':'546',
    'vid': 'f13e99573599a939011b2d590abc95b9' ,
    'playsafe': '4a79ea2e-da86-4fb2-a33f-8f96956e83ce-bn16c998468'
    //'flashvars': {'playsafe': '4a79ea2e-da86-4fb2-a33f-8f96956e83ce-bn16c998468'} // flashvars 方式
    //'playsafeUrl':'https://mydomain.com/getPlaySafeToken' //playsafeUrl 方式
});
</script>

步骤二:后台开通VRM9.0

自助升级操作:
进入保利威点播管理后台 --> 导航栏“设置” --> 加密设置 -->升级至VRM9.0。
upgradeVrm2
温馨提醒:

  1. 请确保认真查阅升级说明再做加密升级,如有疑问请随时联系技术支持人员。
  2. 升级至VRM9.0后只对新上传视频生效。
  3. 只有未升级的老客户才会在后台加密设置页面中显示升级按钮,新客户(默认开通)或已开通的客户不会显示。
以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...

创建 Playsafe Token (v2)

接口URL

https://hls.videocc.net/service/v2/token/create-child

接口说明

  1. 用于创建 Playsafe Token,这个 token 即是加密视频的播放凭证
  2. 如果一个token尚未过期,此时使用相同的 videoId、viewerId、viewerIp、iswxa 参数值请求该接口,则会复用原来的token,并延长原token的有效期。
  3. 该接口目前仅支持子账号。如果要为主帐户创建 token ,可参考 创建 Playsafe Token

支持格式

JSON

请求方式

POST

请求数限制

TRUE

请求参数

参数名 必选 类型 说明
appId string 子账号 appId
videoId string 视频ID,例如 e6b23c6f519c5906e54a13b8200d7bb0_e
ts long 当前13位毫秒级时间戳,10分钟内有效
viewerId string 观看者ID,要求不同的观看者使用不同的ID
viewerIp string 观看者IP,如果为空,会自动获取调用该接口时的IP
viewerName string 观看者名称
expires long token 有效时长,单位为秒。为空时默认为10分钟。
disposable boolean true 表示 token 仅一次有效(验证一次后,token 就失效了)。
false 则表示在有效期内可以多次验证。默认为 false。
iswxa int 是否微信小程序播放,1为是,0为否。默认为0。
extraParams string 自定义的其它参数
sign string 签名,为32位大写的MD5值,详细的签名规则见下文

响应成功JSON示例:

{
    "code": 200,
    "status": "success",
    "message": "",
    "data": {
        "token": "d8835d53-71f5-40a2-a367-ddb8f8c7f16e-bsbcocx_bk",
        "userId": "e6b23c6f51",
        "appId": "asRocmWigR",
        "videoId": "e6b23c6f51c4b1cb9f0302a92ed42440_e",
        "viewerIp": "127.0.0.1",
        "viewerId": "abcd1234",
        "viewerName": null,
        "extraParams": null,
        "ttl": 600000,
        "createdTime": 1552446282044,
        "expiredTime": 1552446882044,
        "iswxa": 0,
        "disposable": false
    }
}

响应失败JSON示例:

appId 错误

{
    "code": 400,
    "status": "error",
    "message": "user_not_found",
    "data": "user secretKey not found."
}

子账号角色错误(目前仅支持“内容分发”角色)

{
    "code": 400,
    "status": "error",
    "message": "user_children_level_error",
    "data": "user children level error."
}

子账号已过期

{
    "code": 400,
    "status": "error",
    "message": "user_children_expired",
    "data": "user children expired."
}

ts 过期

{
    "code": 403,
    "status": "error",
    "message": "ts_expired",
    "data": "ts parameter is expired."
}

签名错误

{
    "code": 403,
    "status": "error",
    "message": "sign_invalid",
    "data": "sign parameter invalid."
}

响应字段说明

参数名 说明
code 响应代码,200为成功,403为ts过期或签名错误,400为参数错误(例如缺少 userId 或 videoId)
status 成功为success,失败为error
message 成功时为空错误时为错误提示消息
data 成功时为token相关数据,失败时为具体的错误提示
userId 用户ID
appId 子账号ID
videoId 视频ID,例如 e6b23c6f519c5906e54a13b8200d7bb0_e
viewerIp 观看者IP,如果为空,或自动获取调用该接口时的IP
viewerId 观看者ID,要求不同的观看者使用不同的ID
viewerName 观看者名称
extraParams 自定义的其它参数
ttl token 有效时长,单位为毫秒
createdTime token 创建时间
expiredTime token 过期时间
iswxa 是否微信小程序播放,1为是,0为否。
disposable true 表示 token 仅一次有效(验证一次后,token 就失效了)。false 则表示在有效期内可以多次验证。

签名规则

  1. 将除了 sign 之外的全部 非空 请求参数(也就是说,参数值为空的参数,将排除掉,不参与签名的计算),按字典序升序排列,按“参数名1参数值1参数名2参数值2……”的格式拼接起来,例如:ts1552447784505userIde6b23c6f51videoIde6b23c6f51c4b1cb9f0302a92ed42440_eviewerIdabcd1234viewerIp127.0.0.1
  2. 在上述字符串的头、尾分别加上 secretKey。以上述字符串、secretKey为abc为例,得到:abcts1552447784505userIde6b23c6f51videoIde6b23c6f51c4b1cb9f0302a92ed42440_eviewerIdabcd1234viewerIp127.0.0.1abc
  3. 计算上述字符串的MD5值,并转为大写,得到:166D45560D37DDBF0F05081D975231B5

php请求示例

// php
function get_client_ip() {
  if (!empty($_SERVER['HTTP_CLIENT_IP'])) {
    $ipaddress = $_SERVER['HTTP_CLIENT_IP'];
  } elseif (!empty($_SERVER['HTTP_X_FORWARDED_FOR'])) {
      $ipaddress = $_SERVER['HTTP_X_FORWARDED_FOR'];
  } else {
      $ipaddress = $_SERVER['REMOTE_ADDR'];
  }
    return $ipaddress;
}

$appId = 'your appId';       // polyv 提供的 appId
$secretkey = 'your secretkey';     // polyv 提供的接口调用签名访问的key
$videoId = '65956867df8c717eb79136e05394122c_6';  // 视频对应vid
$ts = time() * 1000;      // 时间戳
$viewerIp = get_client_ip();  // 用户 ip
$viewerId = get_viewer_id();      // 自定义用户 id
$viewerName = get_viewer_name();  // 用户昵称, 若值为中文需要urlencode('张三'),可为空
$extraParams = get_extra_params();  // 自定义参数,可为空

/* 将参数 $appId、$secretkey、$videoId、$ts、$viewerIp、$viewerIp、$viewerId、$viewerName、$extraParams
    按照ASCKII升序 key + value + key + value ... +value 拼接
*/
$concated =  'appId'.$appId.'extraParams'.$extraParams.'ts'.$ts.'videoId'.$videoId.'viewerId'.$viewerId.'viewerIp'.$viewerIp.'viewerName'.$viewerName;

// 再首尾加上 secretkey
$plain = $secretkey.$concated.$secretkey;

// 取大写MD5
$sign = strtoupper(md5($plain));



// 然后将下列参数用post请求  https://hls.videocc.net/service/v2/token/create-child 获取 token
$url = 'https://hls.videocc.net/service/v2/token/create-child';
$data = array('appId' => $appId, 'videoId' => $videoId, 'ts' => $ts, 'viewerIp' => $viewerIp, 'viewerName' => $viewerName, 'extraParams' => $extraParams, 'viewerId' => $viewerId, 'sign' => $sign);


$result=post($url, http_build_query($data));

// 获取返回结果的 token, 再传入 playsafe 中播放加密视频
// $token = json_decode($result)->data->token;
$token = json_decode($result)->data->token;
echo $token;

function post($url, $post_data = '', $timeout = 5){
    $ch = curl_init();
    curl_setopt ($ch, CURLOPT_URL, $url);
    curl_setopt ($ch, CURLOPT_POST, 1);
    if($post_data != ''){
        curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data);
    }

    curl_setopt ($ch, CURLOPT_RETURNTRANSFER, 1);
    curl_setopt ($ch, CURLOPT_CONNECTTIMEOUT, $timeout);
    curl_setopt($ch, CURLOPT_HEADER, false);
    curl_setopt($ch, CURLOPT_HTTPHEADER, array('Content-Type: application/x-www-form-urlencoded'));
    $file_contents = curl_exec($ch);
    curl_close($ch);
    return $file_contents;
}
以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...

弹幕管理(导入弹幕)

导入弹幕位置:视频列表-弹幕管理,如下图所示:
弹幕管理
1.点击弹幕管理,弹出弹窗,如下图:
弹幕管理弹窗
注意:这里导入的弹幕文件只支持srt格式的文件,即常用的字幕文件格式
建议您使用第三方的字幕生成软件,可以快速的制作生成文件。
2.点击导入弹幕按钮,选择文件,如下图:
选择srt文件
3.导入成功后,弹幕信息会展示在下方列表中,如下图:
弹幕列表

以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...

获取视频播放预览时长接口

接口URL

http://api.polyv.net/v2/video/{userid}/get-preview-duration

接口说明

通过API获取视频的播放预览时长

支持格式

JSON

请求方式

GET

请求数限制

TRUE

请求参数

参数名 必选 类型 说明
userid string 用户ID
ptime string 当前时间的毫秒级时间戳(13位),3分钟内有效
vid string 视频ID
sign string 签名,为40位大写的SHA1值

JSON示例

{
  code: 200,
  status: "success",
  message: "success",
  data: 10
}
{
  code: 400,
  status: "success",
  message: "success",
  data: "查询的视频不存在."
}
{
  code: 400,
  status: "success",
  message: "success",
  data: "查询的视频没有设置预览时长."
}

字段说明

字段 说明
status 成功/失败状态
code 成功/失败代码
message 成功/失败信息
data 成功:返回预览的时长,单位秒

php请求示例

<?php
  $userid="8f8482aaab";
  $secretkey="AiDQw1mAmi";
  $vid="8f8482aaab8fe7ea12e3314a11a061fc_8";
  $ptime=time()*1000;
  $str="ptime=$ptime&vid=$vid".$secretkey;
  $sign=strtoupper(sha1($str));
  $url="http://api.polyv.net/v2/video/$userid/get-preview-duration?ptime=$ptime&vid=$vid&sign=$sign";
  $content = file_get_contents($url);
  echo $content;
?>

签名规则

将请求参数(sign除外)按照参数名字典顺序排列,用“&”连接参数名与参数值,并在最后加上secretkey的值,生成40位大写的SHA1值,作为sign。

以下是示例过程:

1. 将请求参数按照参数名字典顺序排列为:

ptime="1476753635000";
vid="8f8482aaab8fe7ea12e3314a11a061fc_8";

2. 连接字符串 用“&”连接参数名与参数值,并在最后加上secretkey的值,生成40位大写的SHA1值,作为sign(本示例的值为AiDQw1mAmi),如下:

ptime=1476753635000&vid=8f8482aaab8fe7ea12e3314a11a061fc_8AiDQw1mAmi

3. 生成签名sign

sign为40位大写的SHA1值:

B2E2D7AAB9DFCC8CBFE7EDC919B5F8F6F4E104BC
以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...

设置视频的播放预览时长

接口URL

http://api.polyv.net/v2/video/{userid}/set-preview-duration

接口说明

通过API设置视频的播放预览时长

支持格式

JSON

请求方式

POST

请求数限制

TRUE

请求参数

参数名 必选 类型 说明
userid string 用户ID
ptime string 当前时间的毫秒级时间戳(13位),3分钟内有效
vid string 视频ID
duration int 预览的时长(单位是秒),例如:20
sign string 签名,为40位大写的SHA1值

JSON示例

{
  code: 200,
  status: "success",
  message: "success",
  data: "设置成功."
}
{
  code: 400,
  status: "success",
  message: "success",
  data: "修改的视频不存在."
}

字段说明

字段 说明
status 成功/失败状态
code 成功/失败代码
message 成功/失败信息
data 成功/失败数据

php请求示例

<?php
  $userid="8f8482aaab";
  $secretkey="AiDQw1mAmi";
  $vid="8f8482aaab8fe7ea12e3314a11a061fc_8";
  $duration=10;
  $ptime=time()*1000;
  $str="duration=$duration&ptime=$ptime&vid=$vid".$secretkey;
  $sign=strtoupper(sha1($str));
  $url="http://api.polyv.net/v2/video/$userid/set-preview-duration?ptime=$ptime&duration=$duration&vid=$vid&sign=$sign";
  $content = file_get_contents($url);
  echo $content;
?>

签名规则

将请求参数(sign除外)按照参数名字典顺序排列,用“&”连接参数名与参数值,并在最后加上secretkey的值,生成40位大写的SHA1值,作为sign。

以下是示例过程:

1. 将请求参数按照参数名字典顺序排列为:

duration=10;
ptime="1476753635000";
vid="8f8482aaab8fe7ea12e3314a11a061fc_8";

2. 连接字符串 用“&”连接参数名与参数值,并在最后加上secretkey的值,生成40位大写的SHA1值,作为sign(本示例的值为AiDQw1mAmi),如下:

duration=10&ptime=1476753635000&vid=8f8482aaab8fe7ea12e3314a11a061fc_8AiDQw1mAmi

3. 生成签名sign

sign为40位大写的SHA1值:

B2E2D7AAB9DFCC8CBFE7EDC919B5F8F6F4E104BC
以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...