发布与分享
将本地可运行的互动应用发布为网页链接,选择托管方式,配置服务端和允许域名,并验证访问效果。
本页目录
发布后,其他人可以通过网页链接访问应用。先确认本地应用能展示真实空间,并且需要分享的功能已经可用。
选择发布方式
使用 WorkBuddy 开发时,可以继续让它通过自带的“网站应用”托管前端和 Node.js 服务端,具体步骤见 WorkBuddy 发布指南。仅展示空间和已有交互时,无需开启它单独提供的云服务。
也可以部署到你自行管理、支持 Node.js 的托管环境。应用包含网页前端和访问如视接口的服务端,单独上传 dist 静态目录不能完成整个部署。
确认分享范围
选择允许访客查看的空间,并让服务端只接受这些空间的 VR ID。设置默认空间不会缩小 AK/SK 的权限;访客修改地址或请求中的 VR ID 时,也必须受到同样限制。
根据内容决定谁可以访问。需要登录或访问控制时,在分享前完成对应功能和验证;持有链接即可访问的页面应只展示适合公开或按此方式分享的数据。
配置托管环境
让 AI 或负责部署的开发者完成以下事项:
- 核对托管环境的 Node.js、npm 与工程版本要求,确认平台的启动命令、监听地址和端口规则。
- 使用工程的构建命令生成网页产物,启动完整的 Node.js 服务端。标准工程提供
npm run build和npm start,具体适配以生成工程和托管平台要求为准。 - 将 AK/SK 仅配置在服务端。优先使用平台提供的服务端密钥配置;前端产物、公开文件、日志和聊天中不得包含凭据。
- 检查服务端只对外提供预期网页目录和接口,配置文件与配对材料无法通过网页下载。
WorkBuddy 当前验证过的服务端文件配置方式,以及上传前需要确认的内容,见对应指南。不同托管环境的配置方式不能直接照搬。
配置允许域名
取得发布链接后,确认实际发布域名(hostname),联系如视开放平台配置本次 AK 的域名白名单(allow host)。
目前处于限时免费阶段,白名单仅支持联系我们进行后台配置,暂不支持自助修改。 请说明所用组织、开发者应用和实际域名,无需提供 SK。收到配置完成的确认后再验证线上访问。
检查并分享
用完整分享链接打开应用,确认真实 VR 渲染和至少一项已有交互。健康检查成功、接口返回数据或页面显示空间名称,都不能代替浏览器中的真实画面。
按实际使用场景检查手机、电脑和外部网络访问。确认效果后,把完整链接交给使用者;平台附带的访问参数应一并保留。
更新与维护
修改功能后重新构建、发布并检查。轮换 SK 时同步更新托管端配置,仅修改本地文件不会更新线上应用。停止使用时,在托管平台下线应用,并按凭据管理要求处理相关密钥。
持续运行前,确认托管平台的配额、费用、运行时支持和配置维护方式。