すべてのプロダクト
Search
ドキュメントセンター

Mobile Platform as a Service:Android

最終更新日:Jan 17, 2025

このトピックでは、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 つのステップが含まれます。

  1. SDK を追加する

  2. SDK を使用する

前提条件

mPaaS をプロジェクトに統合済みであること。

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 メソッドを呼び出す前に、この API を呼び出します。この API は、ベースライン 10.1.60 以降のバージョンでのみ使用できます。

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 を呼び出して、ビジネスデータを受信する callback を登録できます。この API が呼び出されると、クライアント SDK は同期データを受信した後に syncCallback クラスを呼び出します。

unregisterBiz(String bizType)

指定された同期構成の登録を解除します。この API が呼び出されると、クライアント SDK は同期データを受信したときに syncCallback クラスを呼び出しません。

reportMsgReceived(SyncMessage syncMessag)

syncCallback 実装クラスでデータが受信された後、この API が呼び出されて、同期データが受信されたことが MSS に通知されます。reportMsgReceived メッセージを受信する前に、MSS は最大 6 回データの再送信を試みます。すべての再送信の試みが失敗した場合、データは完全に削除されます。

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

次のステップ