全景剪辑pro第三方插件使用说明

1、新增或编辑全景剪辑

htpp://open.vr.detuyun.com/api?appkey={your_appkey}&name={vr_name}&return_uri={return_uri}&id={vr_id}&category={category}&mark={mark}&markid={markid}&sign={sign}

参数名称 说明
your_appkey 您帐号对应在得图云的appkey(Access Key)
vr_name 需要创建的剪辑项目的名称(不允许包含/和\,编辑漫游时

如果有vr_id参数那么此参数可以省略)

return_uri 全景剪辑发布后的回调地址
vr_id 编辑全景剪辑时指定得图云全景剪辑唯一ID值,

此值在发布回调时可以获得(新增全景剪辑时无需此参数)

category 新增全景剪辑时,执行剪辑存放分类(值如: /1/2 )
mark 第三接入时用于区分第三用户的字段,此值必须为int
markid 回调给第三方的漫游项目标记,

发布剪辑时会将接收的值回调给第三方

sign md签名验证, 值为md5($your_appkey.$your_appsecret.$return_uri.

$mark.$markid.$vr_id.$var_name.$category)

新建项目php代码示例

//新建全景剪辑项目
$return_uri = ‘http://www.detuyun.com'; //发布后的回调地址
$name = ‘全景剪辑1′;
$appkey = ‘access key'; //得图云上的access key
$appsecret = ‘access secret'; //access key 对应的 access secret
$category = ‘/1/2′; //剪辑创建在分类1下的分类2中
$mark = 110; //第三方用户标识,必须为int
$markid = ‘1’;
$id = ”; //新建时,此参数为空或者不要
$sign = md5($appkey.$appsecret.$return_uri.$mark.$markid.$id.$name.$category);;
$params = array(‘return_uri’=>$return_uri,’name’=>$name,’appkey’=>$appkey,’sign’=>$sign,’mark’=>$mark,’markid’=>$markid,’category’=>$category);
$uri = ‘http://open.vr.detuyun.com/api?’.http_build_query($params);
header(‘location:’.$uri);
exit();

发布后回调的地址为:

http://www.detuyun.com?id=1237&mark=110&markid=1&uri={view uri}&sign=asdasuyoh66jh

回调参数说明:

参数名称 说明
id 回调当前发布的全景剪辑在得图云上的唯一ID值,存储起来用于删除和编辑。
mark 接入时接收到的mark值。
markid 接入时接收到的markid值。
uri 全景剪辑查看的地址。
sign 签名用于检验是否为得图云回调,值为md5($id.$appey.$appsecret.$mark.$uri.$markid)

回调验证代码示例:

$id = $_GET[‘id];
$mark = $_GET[‘mark];
$markid = $_GET[‘markid];
$uri = $_GET[‘uri];
$sign = $_GET[‘sign];
$appkey = ‘access key';
$appsecret = ‘access secret';
$my_sign = md5($id.$appkey.$appsecret.$mark.$uri.$markid);
//签名匹配
if($sign == $my_sign){
#do something
}

2、删除全景剪辑

http://open.vr.detuyun.com/api/delete?appkey={your_appkey}&id={id}&sign={sign}

参数名称 说明
your_appkey access key
id 发布漫游时接收到的id值, 得图云全景剪辑唯一ID。
sign 签名,值为md5($appkey.$appsecret.$id)。

php代码示例:

$appkey = ‘access key';
$appsecret = ‘access secret';
$id = ‘DETUYUN_VR_ID';

$sign=md5($appkey.$appsecret.$id);

$param = array(‘appkey’=>$appkey,’id’=>$id,’sign’=>$sign);
$uri = ‘http://open.vr.detuyun.com/api/delete?’.http_build_query($param);
$ch = curl_init();
$timeout = 30;
curl_setopt($ch, CURLOPT_URL, $uri);
curl_setopt($ch, CURLOPT_FAILONERROR, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, $timeout);
$reponse = curl_exec($ch);
curl_close($ch);
//删除成功
if($response == ‘ok’){
#do something
}

3、错误说明

跳转到得图云全景漫游开放插件时,如果发生错误,那么会将错误信息回调到第三方指定的回调地址,错误参数为msg。如:http://www.detuyun.com?msg=error+sign

错误代码 错误说明
error sign 签名错误
error appkey appkey错误
error mark mark错误,mark必须为int类型的值
error category category错误

发表评论

电子邮件地址不会被公开。 必填项已用*标注