快速开始
欢迎使用 OMI 玩具车远程控制平台！本文档将帮助您快速了解并集成 OMI API，让远程控制变得简单易用。
简介
OMI 是一个功能强大、安全可靠的玩具车远程控制平台，专门为开发者提供简单易用的 RESTful API，支持第三方应用快速集成玩具车远程控制能力。
平台核心能力
- 智能设备管理：提供完善的注册、绑定、管理功能，支持多种设备类型
- 实时远程控制：基于 Web 控制面板，实现低延迟、流畅的实时远程控制
- 便捷应用集成：标准 RESTful API 设计，简单易用，快速集成
- 安全可靠认证：基于 Token 的安全认证机制，Token 有效期 3 小时
Base URLs
典型使用场景
1. 远程玩具车体验
用户通过手机应用远程控制玩具车，体验驾驶乐趣，无需实际到场即可享受遥控体验。
2. 亲子互动场景
家长远程控制玩具车与孩子互动，增进亲子关系，即使在异地也能陪伴孩子玩耍。
3. 教育培训应用
学校和教育机构通过玩具车进行驾驶教学和交通安全教育，寓教于乐。
4. 娱乐竞技活动
组织远程玩具车比赛和竞技活动，支持多人在线竞技，增加趣味性。
5. 技术展示演示
企业和开发者展示远程控制技术和物联网应用，展示技术实力。
快速集成步骤
步骤 1：创建应用
首先需要在 OMI 平台创建应用，获取应用凭证 appId 和 appSecret。这些凭证将在后续所有 API 调用中用于身份认证。
重要提示
请妥善保管您的 appSecret，不要泄露给第三方。
步骤 2：获取访问 Token
使用应用凭证获取访问 Token，Token 将用于后续所有需要认证的 API 调用：
javascript
const token = await getToken(appId, appSecret);Token 有效期
获取的 Token 有效期为 3 小时，过期后需要重新获取。
步骤 3：获取控制地址
通过玩具车序列号（SN）获取控制面板地址，返回的 URL 可用于在浏览器中打开或嵌入到 iframe 中实现远程控制：
javascript
const controlUrl = await getControlUrl(deviceSn, token);步骤 4：启动控制
将获取到的控制地址嵌入到您的应用中，用户可以开始远程控制玩具车。
详细步骤和完整代码示例请查看 集成步骤。