このトピックでは、MSS を Android クライアントに迅速に統合する方法について簡単に説明します。 Native AAR または Portal & Bundle を介して MAS にアクセスできます。
重要: 2020 年 6 月 28 日以降、mPaaS はベースライン 10.1.32 のサポートを停止しました。10.1.68 または 10.1.60 を代わりに使用してください。ベースラインをバージョン 10.1.32 から 10.1.68 または 10.1.60 にアップグレードする方法については、「mPaaS 10.1.68 アップグレードガイド」または「mPaaS 10.1.60 アップグレードガイド」をご参照ください。 |
完全なアクセスプロセスには、主に次の 2 つのステップが含まれます。
前提条件
mPaaS をプロジェクトに統合済みであること。
Native AAR を介して MSS にアクセスする場合は、mPaaS をプロジェクトに追加するを完了していることを確認してください。
コンポーネント化アクセスモード (Portal & Bundle プロジェクト経由) で MSS にアクセスする場合は、コンポーネント化アクセスプロセスを完了するを完了していることを確認してください。
SDK を追加する
Native AAR モード
AAR コンポーネント管理の手順に従って、同期コンポーネント管理 (AAR) を使用して コンポーネントをプロジェクトにインストールします。
コンポーネント化アクセスモード
SYNC コンポーネントを、コンポーネント管理 (AAR) を使用して Portal プロジェクトと Bundle プロジェクトにインストールします。
詳細については、「コンポーネントの依存関係を管理する > コンポーネントの依存関係を追加/削除する」をご参照ください。
SDK を使用する
ベースライン 10.1.32 以降のバージョンでは、mPaaS 中間層の MPSync クラスが MSS のすべての API をカプセル化しています。次の表でこれらの API を簡単に確認できます。 API の詳細については、「Android API リファレンス」をご参照ください。
API | 説明 |
setup(Application application) | MSS が依存する基本サービスを初期化します。 |
initialize(Context context) | API と MSS を初期化します。 |
appToForeground() | アプリがフォアグラウンドに切り替えられ、サーバーに接続する必要があることをクライアント SDK に通知します。アプリがフォアグラウンドに切り替わるたびに、この API を呼び出します。 |
appToBackground() | アプリがバックグラウンドに切り替えられ、サーバーから切断する必要があることをクライアント SDK に通知します。アプリがバックグラウンドに切り替わるたびに、この API を呼び出します。 |
updateUserInfo(String sessionId) | ログイン情報 (userId または sessionId) が変更されたときに、この API を呼び出します。この API は少なくとも 1 回呼び出されます。 |
clearUserInfo() | ユーザーがログアウトするときにユーザー情報をクリアします。 |
registerBiz(String bizType, ISyncCallback syncCallback) | この API を呼び出して、ビジネスデータを受信する |
unregisterBiz(String bizType) | 指定された同期構成の登録を解除します。この API が呼び出されると、クライアント SDK は同期データを受信したときに |
reportMsgReceived(SyncMessage syncMessag) |
|
isConnected() | MSS が正しく実行されているかどうかを確認します。 |
コードサンプル
このサンプルは、mPaaS SDK 10.1.32 ベースラインに基づいています。サンプルアプリはボタンを提供します。ユーザーがこのボタンをタップすると、MSS はデバイス ID を取得し、コンソールで指定されたターゲットデバイスにデバイス ID に基づいて同期データをプッシュします。このサンプルでは、同期 ID は bizType です。
注: このサンプルは、MSS API の呼び出し方法を示すことのみを目的としており、MSS のベストプラクティスではありません。MSS のベストプラクティスコードは、コードサンプルを入手するから入手できます。
public void button1Clicked(View view)
{
// getUtdid メソッドを使用してデバイス ID を取得します。
String utdid =UTDevice.getUtdid(MainActivity.this);
// Logcat にモバイル同期データを出力します。
Log.e("=========",utdid);
// API と MSS を初期化します。
MPSync.initialize(MainActivity.this);
// サービスデータを受信するためのコールバックを登録します。この API が呼び出されると、クライアント SDK は同期データを受信した後に syncCallback クラスを呼び出します。
MPSync.registerBiz("bizType",new SyncCallBackImpl());
// サーバーとのネットワーク接続をセットアップします。
MPSync.appToForeground();
}
public class SyncCallBackImpl implements ISyncCallback
{
@Override
public void onReceiveMessage(SyncMessage syncMessage) {
// Logcat にモバイル同期データを出力します。
Log.e("=========",syncMessage.msgData);
// 同期データが受信されたことを MSS サーバーに通知します。
MPSync.reportMsgReceived(syncMessage);
}
}