支付宝小程序：Client SDK

初始化可以直接修改 Application：

public class MainApplication extends AromeApplication {r    @Overrider    protected void attachBaseContext(Context context) {r        super.attachBaseContext(context);r        MultiDex.install(this);r    }r}

也可以自行选择时机调用

1. 设置 application context：

AromeInit.attachApplicationContext(context);

1. 服务初始化（后续 API 调用依赖于服务初始化完成，如果不提前初始化，则会在第一次 API 调用的时候进行初始化）：

// 默认配置初始化rAromeInit.init();rr// 使用对应初始化参数rBundle themeConfig = new Bundle();rthemeConfig.putString("mode", "portrait");rthemeConfig.putString(InitOptionParams.THEME_CONFIG_BG_COLOR, "#FFFF00");rAromeInit.init(new AromeInitOptions.Builder()r                        .loginMode(1)r                        .hardwareType(0)r                        .hardwareName("AlipayCar")r               ttt.themeConfig(themeConfig)r                        .build());rr// 使用对应初始化参数，并需要完成回调rAromeInit.init(new AromeInitOptions.Builder()r                        .loginMode(1)r                        .hardwareType(0)r                        .hardwareName("AlipayCar")r               ttt.themeConfig(themeConfig)r                        .build(),r                new AromeInit.Callback() {r                    @Overrider                    public void postInit() {rttttttLog.d(TAG, "i am on mainthread");r                    }r                    r                    @Overrider                    public void serverDied() {r                        Log.d(TAG, "server process died! need re activate!");r                    }r                });

• loginMode

  • 0 手动登入登出

  • 1 悬浮球头像露出，用户可登出

  • 2 悬浮球倒计时露出，超时无操作自动登出

• hardwareType

  • 1 小鹏汽车（车机竖屏小程序窗口）

  • 1001 天猫精灵（横屏小程序窗口）

• hardwareName

  • 硬件名称，通过 getSystemInfo 的 device 字段透出，区别开移动端的 app 字段。让开发者有能力从硬件维度做适配兼容。

• themeConfig

  • 主题参数配置，bundle类型，支持传参如下

• themeConfig 图示

  • 横屏模式

    

  • 竖屏模式

    

建议：API 不要在主线程调用，否则可能在服务未初始化完成前抛出异常。

如果必须要在主线程调用，务必保证调用前检查 AromeInit.isServiceOnline 返回 true。

AromeActivateRequest request = new AromeActivateRequest();rrequest.hostAppId = "hostAppId#123";rrequest.productId = "productId#213";rrequest.deviceId = "deviceTest#2344";rrequest.signature = "signature#1r2334";rAromeServiceInvoker.invoke(request, new AromeServiceTask.Callback() {r    @Overrider    public void onCallback(final AromeActivateResponse response) {r        mHandler.post(new Runnable() {r            @Overrider            public void run() {r                responseTextView.setText(response.toString());r            }r        });r    }r});

请求参数：

结果参数：

错误码说明：

AromeLoginRequest request = new AromeLoginRequest();rAromeServiceInvoker.invoke(request, new AromeServiceTask.Callback() {r    @Overrider    public void onCallback(final AromeLoginResponse response) {r        mHandler.post(new Runnable() {r            @Overrider            public void run() {r                responseTextView.setText(response.toString());r            }r        });r    }r});

请求参数：暂无

结果参数：

AromeLogoutRequest request = new AromeLogoutRequest();rAromeServiceInvoker.invoke(request, new AromeServiceTask.Callback() {r    @Overrider    public void onCallback(final AromeLogoutResponse response) {r        mHandler.post(new Runnable() {r            @Overrider            public void run() {r                responseTextView.setText(response.toString());r            }r        });r    }r});

请求参数：暂无

结果参数：

AromeLaunchAppRequest request = new AromeLaunchAppRequest();rrequest.appId = miniAppId.getText().toString();rrequest.page = miniAppPage.getText().toString();rrequest.query = miniAppQuery.getText().toString();rBundle themeConfig = new Bundle();rthemeConfig.putInt(RequestParams.REQUEST_KEY_SHOW_TYPE, 123);rthemeConfig.putBoolean(RequestParams.REQUEST_KEY_SAVE_TO_RECENT, false);rAromeServiceInvoker.invoke(request, new AromeServiceTask.Callback() {r    @Overrider    public void onCallback(final AromeLaunchAppResponse response) {r        mHandler.post(new Runnable() {r            @Overrider            public void run() {r                responseTextView.setText(response.toString());r            }r        });r    }r});

• 横屏模式

showType=123

showType=23

showType=12

showType=2

• 竖屏模式

showType=12

showType=21

AromeExitAppRequest request = new AromeExitAppRequest();rrequest.appId = miniAppId.getText().toString();rAromeServiceInvoker.invoke(request, new AromeServiceTask.Callback() {r    @Overrider    public void onCallback(final AromeExitAppResponse response) {r        mHandler.post(new Runnable() {r            @Overrider            public void run() {r                responseTextView.setText(response.toString());r            }r        });r    }r});

请求参数：

结果参数：

错误码说明：

AromePreloadAppRequest request = new AromePreloadAppRequest();rrequest.appId = miniAppId.getText().toString();rrequest.loadToMemory = false;rAromeServiceInvoker.invoke(request, new AromeServiceTask.Callback() {r    @Overrider    public void onCallback(final AromePreloadAppResponse response) {r        mHandler.post(new Runnable() {r            @Overrider            public void run() {r                responseTextView.setText(response.toString());r            }r        });r    }r});

请求参数：

结果参数：

错误码说明：

Set appIdSet = new HashSet();r// 填充 appIdSetrAromeBatchPreloadAppRequest request = new AromeBatchPreloadAppRequest();rrequest.appIds = appIdSet;rAromeServiceInvoker.invoke(request, new AromeServiceTask.Callback() {r    @Overrider    public void onCallback(final AromePreloadAppResponse response) {r        mMainHandler.post(new Runnable() {r            @Overrider            public void run() {r                mResponseTextView.setText(response.toString());r            }r        });r    }r});

请求参数：

结果参数：

错误码说明：

AromeGetAppStatusRequest request = new AromeGetAppStatusRequest();rrequest.appId = miniAppId.getText().toString();rAromeServiceInvoker.invoke(request, new AromeServiceTask.Callback() {r    @Overrider    public void onCallback(final AromeGetAppStatusResponse response) { r        mMainHandler.post(new Runnable() {r            @Override r            public void run() { r                responseTextView.setText(response.toString()); r            }r        }); r    }r});

请求参数：

结果参数：

AromeGetUserInfoRequest request = new AromeGetUserInfoRequest();rAromeServiceInvoker.invoke(request, new AromeServiceTask.Callback() {r    @Overrider    public void onCallback(final AromeGetUserInfoResponse response) {r        mMainHandler.post(new Runnable() {r            @Overrider            public void run() {r                mResponseTextView.setText(response.toString());r            }r        });r    }r});

请求参数：

结果参数：

允许小程序调用第三方 app 提供的硬件能力，如小程序播放车机提供的音乐能力；或设备发送通知给到小程序，如车机通知小程序当前电（油）量低。

通过AromeExtendBridgeRequest注册需要扩展的能力。

请求参数：

结果参数：

例（扩展了 helloAmpe 和 playMusic 两个 API）：

AromeExtendBridgeRequest request = new AromeExtendBridgeRequest();rArrayList extensionList = new ArrayList<>();rextensionList.add("helloAmpe");rextensionList.add("playMusic");rrequest.mExtensionList = extensionList;rAromeServiceInvoker.invoke(request, new AromeServiceTask.Callback() {r    @Overrider    public void onCallback(final AromeResponse response) {r        mMainHandler.post(new Runnable() {r            @Overrider            public void run() {r                mResponseTextView.setText(response.toString());r            }r        });r    }r});

实现注册的能力，当小程序调用对应能力时，会回调onCalled方法，并携带action即对应 API 名称与params即对应调用参数，只需要完成对应的扩展能力，并通过bridgeCallback参数回调即可，如果不需要额外参数回调给小程序可以直接传入null。

AromeServiceInvoker.registerBridgeExtension(new AromeServiceInvoker.BridgeExtension() {r    @Overrider    public void onCalled(String action, String params, AromeServiceInvoker.BridgeCallback bridgeCallback) {r        JSONObject result = new JSONObject();r        try {r            result.put("action", action);r            result.put("params", params);r            result.put("hello", "world");r        } catch (Throwable t) {r            Log.e("test", "onCalled", t);r        }r        String jsonString = result.toString();r        bridgeCallback.callback(jsonString);r    }r});

AromeSendEventRequest sendEventRequest = new AromeSendEventRequest();rsendEventRequest.eventName = "niceToMeetYou";rsendEventRequest.eventData = "{"phonetype":"ABC","cat":"Android"}";rAromeServiceInvoker.invoke(sendEventRequest, new AromeServiceTask.Callback() {r    @Overrider    public void onCallback(final AromeResponse response) {r        mMainHandler.post(new Runnable() {r            @Overrider            public void run() {r                mResponseTextView.setText(response.toString());r            }r        });r    }r});

需要在注册实现的 API 名称前增加 "ampe_"，来调用到真正实现的能力（如上例中的 helloAmpe ）：

my.call('ampe_helloAmpe', {}, res => {r  console.log("result", res);r});

my.on('niceToMeetYou', e => {r  console.log("event", e);r})