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();