EyeSpy360 API 和 SDK

什么是 EyeSpy360™ 虚拟游览?


用户使用快速简单的 EyeSpy360 Virtual Tour Editor 创建和发布自己创建和发布的属性、船只、酒店等的完全身临其境的 360 度演练。在https://www.eyespy360.com上观看我们的演示视频。这真的很简单。


什么是 EyeSpy360™ HTML 小工具?


EyeSpy360 Widget 是一个 API / SDK,允许您将虚拟旅游创建和发布添加到您自己的财产列表编辑器。它就像添加一行代码一样简单:


 <script src="https://e3.eyespy360.com/widget/virtual-tours.1.0.2.js?key=1234&secret=ABCDEF&externalTourID=myPropertyID&target=virtualTourURL"></script> 


这是给谁的?


您已经运行了一个财产清单管理系统,您的用户可以在其中创建、编辑和发布财产清单。这些清单包括描述和图像,您希望让您的用户能够创建 360 度虚拟游览。


它是如何工作的?


您可能已经有一个虚拟旅游 URL 表单字段用于您的财产列表数据记录和编辑表单。如果没有,请先创建一个。添加 EyeSpy360 Widget 一行嵌入代码,并将目标参数设置为虚拟游览 URL 的 HTML 输入字段的 ID,例如<input id="virtualTourURL" 。该小部件将自动在输入字段后放置一个 Virtual Tour Editor 按钮。



当用户单击 Tour Editor 按钮时,EyeSpy360 Tour Editor 将以 95% x 95% 的弹出窗口出现在同一网页内。用户上传 360 度图像,通过入口和出口链接它们,预览虚拟旅游并单击“发布”。发布的 URL 会自动输入到目标小部件参数指定的虚拟旅游 URL 表单字段中。当用户单击右上角的关闭按钮时,或者如果用户在导览编辑器外部单击,导览编辑器将关闭,此时主网站仍然在 5% 的弹出窗口边距中可见。


然后,当用户保存他们的更改时,您将在数据库中存储虚拟旅游 URL 值以及用户修改的任何其他字段。


小部件参数


key, secret - 强制性的。密钥和秘密字段显示在https://e3.eyespy360.com的“设置 -> API 凭据”部分下。没有 EyeSpy360 帐户?免费获得一个

externalTourID - 强制性的。您提供的唯一标识符。最大长度 36 个字符。您将已经在某个唯一标识符下将您的属性存储在数据存储中。在这里使用它。

目标- 强制性的。 EyeSpy360 Virtual Tour 编辑器将放置 Tour URL 的 HTML 输入字段的 ID。

代理- 可选。如果您的物业管理系统是多用户甚至是多公司,请将此字段设置为用户或公司名称。这将帮助您在 EyeSpy360 后端跟踪哪些旅行属于哪个代理。示例:Jon Doe、Jane Doe、Doe Estates

游览- 可选。虚拟游览的名称。将此设置为您的财产列表标题,这样您的用户就不需要在游览编辑器中再次输入它。示例:卡文迪许之家

hl - 可选。界面语言。支持的值为 ar、bg、de、en、es、fr、nl、pt、ru、th、zh。默认为“en”


小部件按钮自定义


您几乎肯定会希望更改“游览编辑器”按钮的外观以匹配您自己网站的外观和感觉。您可以通过将任何您喜欢的 CSS 应用于 eyespy360_btn 元素来实现。例子:

 #eyespy360_btn {
  红色;
  字体粗细:粗体;
  左边距:10px;
}


安卓虚拟旅游SDK


您还可以将 EyeSpy360 Tour Editor 直接嵌入到您的 Android 应用程序中。https://github.com/eyespy360/Virtual-Tour-Android-SDK查看 SDK


iOS虚拟旅游SDK


您还可以将 EyeSpy360 Tour Editor 直接嵌入到您的 iOS 应用程序中。查看 SDK: https://github.com/eyespy360/Virtual-Tour-iOS-SDK


测试内容


全景图和平面图:

https://www.eyespy360.com/downloads/EyeSpy360_Test_Images.zip


如何将游览嵌入我发布的房产列表中?


嵌入到 iframe 中:

 <iframe width="640" height="390" src="virtualTourURL" allowfullscreen></iframe>


其中VirtualTourURL是您的数据存储中的值。调整宽度高度以匹配您的设计。