SmartWatch2开发-开发者规范

原文地址

1. Sony SmartWatch产品详细规范

Sony SmartWatch产品是用来补充/扩展Android移动设备功能的配件。SmartWatch为触屏配件，使用蓝牙跟Android手机或平板通讯。目前该产品包括SmartWatch(MN2)和SmartWatch 2(SW2)。

SmartWatch配置以下：

• 振动器
• 加速度计
• 按钮(应用不可用)

SmartWatch 2配置以下：

• 振动器
• 加速度计
• 光传感器
• Action Key
• 后退键
• Home键(应用不可用)

注意：LED和Text to speech不可用于为SmartWatch 2开发的app

一、蓝牙通讯 二、包括SmartWatch(MN2)和SmartWatch2(SW2)

SmartWatch配置： Vibrator, Accelerometer, Button(不可用于app) SmartWatch2配置： Vibrator, Accelerometer, Light sensor, Action key, Back key, Home key(不可用于app)

注意LED和Text to speech不可用于为SmartWatch 2开发的app

2. 硬件配置

<table> <tr> <td> 产品 </td> <td> SmartWatch </td> <td> SmartWatch 2 </td> </tr> <tr> <td> 屏幕类型 </td> <td> OLED, 16-bit </td> <td> TFT, 16-bit </td> </tr> <tr> <td> 分辨率 </td> <td> w:128px, h:128px </td> <td> w:220, h:176px </td> </tr>

</table>

3. API兼容性

<table> <tr> <td> 产品 </td> <td> SmartWatch </td> <td> SmartWatch 2 </td> </tr> <tr> <td> Control API v1.0 </td> <td> 支持 </td> <td> 支持 </td> </tr> <tr> <td> Control API v2.0 </td> <td>

</td>
<td>
支持
</td>

</tr> <tr> <td> Registration & Capabilities API v1.0 </td> <td> 支持 </td> <td> 支持 </td> </tr> <tr> <td> Registration & Capabilities API v2.0 </td> <td>

</td>
<td>
支持
</td>

</tr> <tr> <td> Notification API v1.0 </td> <td> 支持 </td> <td> 支持 </td> </tr> <tr> <td> Notification API v2.0 </td> <td>

</td>
<td>
支持
</td>

</tr> <tr> <td> Sensor API v1.0 </td> <td> 支持 </td> <td> 支持 </td> </tr> <tr> <td> Widget API v1.0 </td> <td> 支持 </td> <td>

</td>

</tr> </table>

1.针对SmartWatch

• 不建议同时在Smart Extension App中使用Control API和Notification API，(因为某些缘由??)当用户点击app图标时行为未定义
• 对于使用了Notification API但没有使用Widget API的Smart Extension App，主app会自动建立一个widget。缺省时禁用了这个Widget，用户能够在主应用中启用。

2.SmartWatch2

• 同时使用Notification API和Control API的Extension不支持指定launch mode。永远启动事件列表(??? 原文是 It will always launch the list of events, just as the original SmartWatch does)。 但仍然建议Extension设置launch mode(??? 不太明白， 为支持后续升级吗? )。当SmartWatch 2将来升级支持launch mode后，Extension的行为不会发生变化。新版本的Smart Extension API(2.0及之后版本)能够在未设置launch mode时指定缺省启动Extension的控制部分。
• 使用Control API的Smart Extension同一时刻只能有一个可见的ListView或Gallery
• SmartWatch 2中每一个Extension能够最多能够存放并显示30个事件。
• SmartWatch 2的振动器最小振动时间为250ms，最长能够持续振动6s。6s后振动器会自动中止以省电。

4. 电池

SmartWatch是高性能的智能配件，因此须要合理地使用电池。主应用和Sony Add-on SDK包含提供一些节省电量的功能。但Extension最好遵循如下建议：

• 没必要要时应避免发送大尺寸图片(发送缩略图便可)
• 避免使用[Control.SCREEN_STATE_ON][] <!--TODO-->
• 使用传感器时，当传感器状态变化时，仅使用SensorInterruptMode.SENSOR_INTERRUPT_ENABLED来接收传感器数据
• 避免过分使用振动器

5. 传感器

使用传感器用SmartExtensionUtils.isSensorSupported()进行检查。可参考SampleSensorExtension参考这个方法的使用方法

6. 加速度计

加速度计仅可用于当前正在运行的Extension。若是屏幕熄灭，或按下power键，或者另外一个Extension启动了，致使当前Extension暂停，那么加速度计将中止。

若是Extension仍然想接收到传感器数据，则须要使用SCREEN_STATE_ON, SCREEN_STATE_OFF或 SCREEN_STATE_DIM Intent

7. 后台进程

全部的Smart Extension app运行在service中。Android中的service为后台进程，而同时运行的后台进程数量是有限的，因此Android会中止最近未使用的进程。甚至当Smart Extension app在前台显示时这种状况也会发生。一般这不会是什么大问题由于Smart Extension app仅在前台并和用户直接交互很短的一段时间。另外，SmartExtensionUtils中提供方法用于Smart Extension app与用户交互时被中止掉时的恢复。

对须要长时间运行且不该被停止的Smart Extension app，可使用Service.startForeground()方法来将后台进程变成前台进程。这么作的反作用是service在前台运行时状态栏会出现一个notification。

8. 在Play上发布

开发一款Extension后，当终端用户在SmartConnect中搜索兼容的应用时能被找到，能够增长曝光度。

为了更容易被搜索到，支持SmartWatch 2的应用最好在应用描述中增长如下内容：

Smart Connect extension for SmartWatch 2

9. 其余信息

这里讨论的是SmartWatch 2(略过了关于SmartWatch的，更多信息请参考原文)

显示

若是Extension同时使用Control API 和 Notification API，在SmartWatch 2上点击Extension的图标时会弹出Notification页面——即显示最近的Notification。虽然SmartWatch 2还不支持launch mode，但仍是建议你在Extension注册时设置Extension的launch mode。这样能够防止将来SmartWatch 2升级(升级后能够支持完整的launch mode)时Extension的launch行为发生变化(将来缺省启动Extension的Control API部分)

Extension将其图片或布局发送到主应用，主应用会将图片和布局转换成配件支持的格式。

控制

Extension使用Control API来控制整个屏幕。为了能支持为SmartWatch写的应用，某些状况下使用Control API提供的显示数据(图片或布局)会被缩放。缩放过程对Extension来讲是透明的。主应用自动缩放图片，触摸事件坐标等等，不会影响长宽比。缩放过程保证高度能够填满整个屏幕且正好水平居中。The scaling is triggered if the first display data sent by the Control API after it’s launched is positioned at (0,0) and the display data has a size of 128 x 128 pixels（????不清楚）当Extension不显示时缩放效果再也不起做用。若是原始大小是220x176px，不会对显示数据进行任何缩放。

使用Control API的Extension， 能够支持touch(经过CONTROL_ TOUCH_ EVENT_ INTENT, CONTROL_ OBJECT_ CLICK_ EVENT_ INTENT, CONTROL_ LIST_ ITEM_ CLICK_ INTENT或者ControlExtension.onTouch()方法)和swipe手势(经过CONTROL_ SWIPE_ EVENT_ INTENT 或者 ControlExtension.onSwipe()方法)。

当使用布局来绘制时，一屏上同时能够显示的View最多为50个。

10. UI设计

见这个文档的第15页