出行SDK介绍

Posted 2022-11-23 IoT砖家涂拉拉

出行 SDK 依赖于涂鸦智能 智能生活 App SDK，基于此基础上进行拓展开发，旨在加速与出行相关的 IoT App 开发进程。SDK 主要包括了以下功能：

• 查询出行设备信息，包括高清大图、设备固件信息
• 设备 DP 快捷操作管理
• 线下⻔店相关接口，包括获取及搜索线下门店
• 骑⾏导航相关接口，包括获取骑行轨迹以及上传骑行轨迹

准备工作

您需要在涂鸦IoT开发平台上注册账号、创建 户外出行 相关产品等，例如 防丢器、车载定位器、智能电动车 等。然后获取到激活出行 SDK 的密钥。具体的操作流程请参考 快速集成安卓 App SDK我的上一篇博文《如何将安卓版智能生活 App SDK 集成到开发环境中？》

快速集成

1. 在 build.gradle 文件的 repositories 增加以下配置：

   maven 
     url "https://maven-other.tuya.com/repository/maven-releases/"
   
   

2. 在 build.gradle 文件里添加集成准备中下载的 dependencies 依赖库。

   dependencies
   	implementation 'com.tuya.smart:tuyasmart:4.0.0'
   	implementation 'com.tuya.smart:tuyasmart-outdoor-sdk:1.0.0'
   
   

Demo App

下面我将演示如何使用智慧出行 android SDK 构建出行应用程序。智慧出行 Android SDK 分为多个功能模块，包括设备接口、线下门店、骑行导航。

运行环境

• Android Studio Arctic Fox | 2020.3.1 Patch 4 Build #AI-203.7717.56.2031.7935034, built on November 21, 2021

• Gradle 6.5及以上版本

运行示例

1. 智慧出行 Android SDK 通过 Gradle 进行集成，需要安装相关资源

2. Clone或者下载本示例源码

3. 运行本示例需要AppKey、SecretKey 和 安全图片，你可以前往 涂鸦智能 IoT 平台 注册成为开发者，并通过以下步骤获取：

   1. 登录 涂鸦智能IoT平台，在左侧导航栏面板分别选择： App -> SDK 开发
   2. 点击 创建APP 进行创建应用.
   3. 填写必要的信息，包括应用名称、应用包名等
   4. 点击创建好的应用，在获取密钥面板，可以获取 SDK 的 AppKey，AppSecret，安全图片等信息
   5. 根据iot平台上的帮助信息添加SHA256字符串

4. 打开本示例工程中的 local.properties 文件

5. 在 local.properties 中将获取到的AppKey、SecretKey填写，如下所示

   appKey=你的AppKey
   appSecret=你的AppSecret

     6. 下载安全图片并重命名为t_s.bmp，将安全图片拖拽到工程中 app模块 assets 文件夹下

* 注意: Package Name、 AppKey、AppSecret和安全图片必须跟你在 涂鸦智能 IoT 平台创建的应用保持一致，如果不一致则无法正常运行本示例工程。