kingdong020543
管理员
管理员
  • UID6
  • 粉丝51
  • 关注2
  • 发帖数141
  • 喜欢达人
  • 社区居民
  • 忠实会员
  • 原创写手
阅读:2310回复:0

vuforia Web服务(Vuforia Web Services)

楼主#
更多 发布于:2015-08-20 14:14
VuforiaWeb服务
   VuforiaWeb服务(VWS) API是RESTful API, 使开发者可以在自己的内容管理系统(CMS)使用vuforia云识别服务。通过VWS API,开发者可以实现在CMS上传图像目标到云识别数据库,添加应用程序的元数据,并监控其数据库和目标状态。

使用案例

   VWS API可用于开发内容管理解决方案,与Vuforia云识别服务进行通信。

使用VWS API

   VWS是一个使用HTTP协议的RESTful API。VWS API可以在任何语言在运行时调用,能够进行有效的HTTP请求到远程主机。

开始

   按照这些步骤来开始使用VWS API。


  1. 用你的开发者帐户登录到vuforia目标管理器,注册云识别服务。
  2. 运用目标管理器创建云数据库,参阅:如何创建一个新的云数据库
  3. 在目标管理器Access Keys标签页下载云数据库的服务器访问秘钥。

访问秘钥

   每个数据库有两个秘钥–服务器访问秘钥和客户端访问秘钥。


  • 服务器访问秘钥是用于通过VWS上传和管理数据库中的图片。服务器访问密钥具有读取和写入数据库的权限。
  • 客户端访问秘钥允许一个应用程序的图像识别服务查询数据库。客户端访问秘钥具有只读访问数据库的权限。客户端访问秘钥嵌入在应用程序,当初始化QCAR::TargetFinder时传递给Vuforia SDK

   所有API都是阻塞调用,即只有当所有的处理完成才会有返回值。因此设计你的应用程序UI时应该考虑对于复杂的任务会有较长延迟。

安全

   所有的API调用使用HTTPS的TLS 1,或更高,服务器相互认证。此外,一个特殊的header计算,确保每个数据库只有经过授权才允许访问。

使用API调用

1。添加服务器的访问秘钥到VWS请求的头部,见下文。
2。通过HTTP提交一个完整的VWS API请求到https://vws.vuforia.com
3。解析API请求响应的 JSON体。

VWS API必须包括Authorization标头字段。
使用VWS API的所有的调用必须包括授权标头字段。看起来像下面的例子:



  1. Authorization: VWS{provision_access_key}:{Signature}
复制代码
   server_secret_key 是你建立你的云识别数据库时提供的公共服务器秘钥。

   签名是字符串格式的以下域的连接.



  1. Signature =Base64(HMAC-SHA1(server_secret_key, StringToSign ) ) ;
  2. StringToSign =
  3. HTTP-Verb + "\n" +
  4. Content-MD5 + "\n" +
  5. Content-Type + "\n" +
  6. Date + "\n" +
  7. Request-Path;
复制代码
其中:
  • HTTP-Verb 是用于actionHTTP方法,例如,GETPOST等等。
  • Content-md5 是整个请求的十六进制MD5哈希值(从第一个到最后一个边界,包括边界本身)。请求类型没有请求体,包括MD5哈希一个空字符串“d41d8cd98f00b204e9800998ecf8427e”
  • Content-Type是请求体的内容类型(如 multipart/form-data)。使用请求类型的空字符串没有请求体。
  • Date是当前日期,在RFC 26163.3.1节,rfc1123日期格式,例如,
          Sun
    22 Apr 2012     08:49:37 GMT
  • 注意日期和时间总是指格林威治标准时间。



VWS示例

   Java和PHP在开发者门户的示例代码段中均可用。
1.Java代码示例在一个ZIP文件提供。你必须将文件解压到一个目录,审查代码和更新安全密钥。
2.zip文件包含以下六个文件:
     deletetarget.java
     getalltargets.java
     gettarget.java
     postnewtarget.java
     signaturebuilder.java
     updatetarget.java
3.确保这六个文件在你的工作目录,你必须使用你的access_key和secret_key值更新所有文件。
例如,在deletetarget.java文件看起来像下面的代码:
(JSON)



  1. public class DeleteTarget {

  2.  String access_key = "<your server access key here>";
  3.  String secret_key = "<your server access key here>";
  4.  String targetId = "<your targetID here>";
  5.  String url = "https://vws.vuforia.com";
复制代码
4. 使用access_key,secret_key适当的值更换占位符(“”),并且修改targetid。

欢迎分享

游客

返回顶部