本文档是关于JYSDK使用说明,主要针对的是2019年1月10日发布的一份文档,重点介绍了设备与应用程序之间的连接设置、问题反馈渠道、不同平台的SDK接口操作以及数据结构。以下是详细解读:
1. **单位模式选择**:
文档提及了设备和应用间的距离和温度单位可以选择公制或英制,这可以通过设置私有变量来决定。公制下,距离将以公里(KM)为单位显示;而在英制模式下,距离则以英里(MILE)为单位。这个设置可能会影响到用户界面的呈现方式。
2. **接入与反馈机制**:
如果在使用过程中遇到任何问题,用户可以发送电子邮件至dev@keeprapid.com进行反馈。邮件应包含厂商帐号(vid,即设备的唯一标识符)、设备的MAC地址,以及详细描述问题发生的场景和重现步骤。这有助于开发者更快定位和解决问题。
3. **Android SDK初始化**:
文档提供了一个示例,展示了如何通过在Android项目中的JySDK.xml资源文件中配置AppID、Secret和VID(通常用于身份验证)来初始化和启动SDK。这涉及到将测试时的临时ID替换为正式版本的ID。
4. **数据结构与API调用**:
`BleClientOption`类包含了多个关键的数据结构,如用户的个人信息(userProfile),设备属性(deviceProfile),闹钟列表(itemsTimer)(最多支持5个闹钟,其中一个是久坐提醒),以及天气参数(weather)。用户可以根据需求设置这些对象,比如仅设置闹钟时,只需传递一个包含闹钟信息的`AlarmInfoItem`对象到`mService.setOption()`方法,并调用`mService.setAlarm()`。
5. **接口实现与示例**:
用户需要实现`IServiceCallback`接口来接收和处理来自设备的数据和消息。具体操作中,用户可以创建`BleClientOption`实例,只传入所需的数据,如上面提到的闹钟列表,然后调用相应的服务方法,如`setAlarm()`,以控制设备的行为。
总结来说,这份文档为开发人员提供了JYSDK的基础使用指南,包括配置、问题报告流程以及关键数据结构的管理,确保了开发者能顺利集成和操控该设备的特性。对于开发者来说,理解这些内容对于实现与JYSDK设备的有效交互至关重要。