SmartWatch2开发-ControlSample分析

ControlSample代码路径

安装Sony Add-on SDK后见< Android SDK >\sdk\add-ons\addon-sony_add-on_sdk_2_1-sony-16\samples\SmartExtensions目录

ControlSample是Sony Add-on SDK中的一个Demo，可以运行在Smart Watch2上

运行截图如下

ControlSample分析

1.主要结构

SamplePreferenceActivity

供手机端使用的设置界面

ExtensionReceiver

收到特定广播后启动Extension Service

SampleExtensionService

其createControlExtension方法会根据当前的配件信息(是SmartWatch，SmartWatch2还是其他设备)生成一个合适的ControlExtension

2.SampleControlSmartWatch2

我们的目标机型是Smart Watch 2, 所以重点分析这个类。

2.1 构造方法

SampleControlSmartWatch2(final String hostAppPackageName, final Context context,
Handler handler) {
super(context, hostAppPackageName);
if (handler == null) {
throw new IllegalArgumentException("handler == null");
}
mHandler = handler;
setupClickables(context);
initializeMenus();
}

??为什么这里要从外部传入一个Handler, 虽然是由外部传入的，但并未用于内外通信!!!

2.2 创建布局

LayoutInflater inflater = (LayoutInflater) context.getSystemService
(Context.LAYOUT_INFLATER_SERVICE);
View layout = inflater.inflate(R.layout.sample_control_2
, null);
mLayout = (ControlViewGroup) parseLayout(layout);

注意：

1.sample_control_2.xml中根元素的width为220px, height为176px

2.必须使用parseLayout方法把普通的View转换成ControlViewGroup. (...为什么)

3.ConrtrolViewGroup.findViewById方法返回的是ControlView

4.ConrolView上可以设置click监听

2.3 更新布局

public void onResume() {
Bundle b1 = new Bundle();
b1.putInt(Control.Intents.EXTRA_LAYOUT_REFERENCE, R.id.sample_control_text_1);
b1.putString(Control.Intents.EXTRA_TEXT, "1");

Bundle b2 = new Bundle();
b2.putInt(Control.Intents.EXTRA_LAYOUT_REFERENCE, R.id.sample_control_text_2);
b2.putString(Control.Intents.EXTRA_TEXT, "2");

Bundle[] data = new Bundle[2];

data[0] = b1;
data[1] = b2;

showLayout(R.layout.sample_control_2, data);

startAnimation();
}

showLayout接收Bundle数组，可用于更新布局上的文字

/**
* @param resourceId The new resource to show.
*/
private void updateAnimation(int resourceId) {
sendImage(R.id.animatedImage, resourceId);
}

sendImage的意思跟setImage类似... (很无语)

2.4 如何使用动画

/**
* Start showing animation on control.
*/
private void startAnimation() {
if (!mIsShowingAnimation) {
mIsShowingAnimation = true;
mAnimation = new Animation();
mAnimation.run();
}
}

/**
* Stop showing animation on control.
*/
private void stopAnimation() {
if (mIsShowingAnimation) {
// Stop animation on accessory
if (mAnimation != null) {
mAnimation.stop();
mHandler.removeCallbacks(mAnimation);
mAnimation = null;
}
mIsShowingAnimation = false;
}
}

这里的的Animation是使用Handler来定时更新图片模拟实现的

2.5 事件响应

@Override
public void onTouch(final ControlTouchEvent event) {
if (event.getAction() == Control.Intents.TOUCH_ACTION_RELEASE) {

}
}

@Override
public void onObjectClick(final ControlObjectClickEvent event) {
if (event.getLayoutReference() != -1) {
mLayout.onClick(event.getLayoutReference());
}
}

@Override
public void onKey(final int action, final int keyCode, final long timeStamp) {
if (action == Control.Intents.KEY_ACTION_RELEASE
&& keyCode == Control.KeyCodes.KEYCODE_OPTIONS) {
}
else if (action == Control.Intents.KEY_ACTION_RELEASE
&& keyCode == Control.KeyCodes.KEYCODE_BACK) {
}
}

@Override
public void onMenuItemSelected(final int menuItem) {
Log.d(SampleExtensionService.LOG_TAG, "onMenuItemSelected() - menu item " + menuItem);
if (menuItem == MENU_ITEM_0) {
clearDisplay();

}
}

注意: onMenuItemSelected中调用clearDisplay()，猜测是清屏以隐藏菜单

2.6 弹出菜单

private void toggleMenu() {
if (mTextMenu) {
showMenu(mMenuItemsIcons);
}
else
{
showMenu(mMenuItemsText);
}
mTextMenu = !mTextMenu;
}

3 提供Extension注册信息

Extension安装时必须向主应用注册。实现以下方法以提供注册信息

/**
* Get the extension registration information.
*
* @return The registration configuration.
*/
@Override
public ContentValues getExtensionRegistrationConfiguration() {
String iconHostapp = ...;
String iconExtension = ...;
String iconExtension48 = ...;
String iconExtensionBw = ...;

ContentValues values = new ContentValues();

// 提供Extension的设置界面入口
values.put(Registration.ExtensionColumns.CONFIGURATION_ACTIVITY,
SamplePreferenceActivity.class.getName());
values.put(Registration.ExtensionColumns.CONFIGURATION_TEXT,
mContext.getString(R.string.configuration_text));

// 提供Extension的名字, 这个名字将显示在SmartConnect的Extension列表中
values.put(Registration.ExtensionColumns.NAME, mContext.getString(R.string.extension_name));

// 提供Extension的key, 用于安全校验
values.put(Registration.ExtensionColumns.EXTENSION_KEY,
SampleExtensionService.EXTENSION_KEY);

// 提供一些相关的图片资源
values.put(Registration.ExtensionColumns.HOST_APP_ICON_URI, iconHostapp);
values.put(Registration.ExtensionColumns.EXTENSION_ICON_URI, iconExtension);
values.put(Registration.ExtensionColumns.EXTENSION_48PX_ICON_URI, iconExtension48);
values.put(Registration.ExtensionColumns.EXTENSION_ICON_URI_BLACK_WHITE, iconExtensionBw);

// 支持的Notification API版本
values.put(Registration.ExtensionColumns.NOTIFICATION_API_VERSION,
getRequiredNotificationApiVersion());

// 提供当前Extension的包名， 必须唯一
values.put(Registration.ExtensionColumns.PACKAGE_NAME, mContext.getPackageName());

return values;
}

注意，这个例子并不支持Notification(没有使用Notification API)，所以重写的getRequiredNotificationApiVersion()方法如下：

@Override
public int getRequiredNotificationApiVersion() {
return 0;
}

如果要使用Notification API，这里就不能简单地返回0了，而要返回你需要的Notification API版本。可参考父类RegistrationInformation中的getRequiredNotificationApiVersion()方法的注释

/**
* Get the required notifications API version
*
* @see Registration.ExtensionColumns#NOTIFICATION_API_VERSION
* @see #getSourceRegistrationConfigurations
* @see ExtensionService#onViewEvent
* @see ExtensionService#onRefreshRequest
* @return Required notification API version, or 0 if not supporting
*         notification.
*/
public abstract int getRequiredNotificationApiVersion();