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

Mobile Platform as a Service:Android との統合

最終更新日:Mar 01, 2026

このトピックでは、MSS コンポーネントを Android クライアントと統合する方法について説明します。

説明

2020 年 6 月 28 日以降、mPaaS は 10.1.32 ベースラインのメンテナンスを終了しました。10.1.68 または 10.1.60 ベースラインを使用してください。ベースラインバージョンをアップグレードするには、「mPaaS 10.1.68 アップグレードガイド」または「mPaaS 10.1.60 アップグレードガイド」をご参照ください。

MSS コンポーネントは、ネイティブ AAR ベースの統合コンポーネントベースの統合の 2 つの統合方法をサポートしています。

統合手順は、次の 2 つのステップで構成されます。

  1. SDK の追加

  2. SDK の使用

前提条件

プロジェクトが mPaaS と統合されていること。

SDK の追加

ネイティブ AAR ベースの統合

コンポーネント管理 (AAR) を使用して、プロジェクトに SYNC コンポーネントをインストールします。詳細については、「AAR コンポーネント管理」をご参照ください。

コンポーネントベースの統合

Portal プロジェクトと Bundle プロジェクトで、コンポーネント管理を使用して SYNC コンポーネントをインストールします。

詳細については、「コンポーネントの依存関係の管理 > コンポーネントの依存関係の追加または削除」をご参照ください。

SDK の使用

ベースライン 10.1.32 以降では、mPaaS ミドルウェアレイヤーの MPSync クラスが MSS コンポーネントのすべての API をカプセル化します。MPSync オブジェクトを使用して、すべての MSS 機能にアクセスできます。

次の表は、MSS API の概要を示しています。API の詳細については、「Android API リファレンス」をご参照ください。

API

説明

setup(Application application)

MSS が依存する基本サービスを初期化します。このメソッドは initialize メソッドの前に呼び出す必要があります。このメソッドは、ベースライン 10.1.60 以降でのみ使用可能です。

initialize(Context context)

API と MSS サービスを初期化します。

appToForeground()

アプリが起動されたことをクライアント SDK に通知し、サーバーとのネットワーク接続を確立します。アプリがフォアグラウンドに表示されるたびに、このメソッドを呼び出してください。

appToBackground()

アプリがバックグラウンドに移行したことをクライアント SDK に通知し、サーバーから切断します。アプリがバックグラウンドに移行するたびに、このメソッドを呼び出してください。

updateUserInfo(String sessionId)

userId や sessionId などのログイン情報が変更されたときに、このメソッドを呼び出します。このメソッドは少なくとも 1 回は呼び出す必要があります。

clearUserInfo()

ユーザーをログアウトします。

registerBiz(String bizType, ISyncCallback syncCallback)

ビジネスデータを受信するための callback を登録します。プッシュされたデータが受信されると、クライアント SDK は syncCallback 実装クラスを呼び出します。

unregisterBiz(String bizType)

指定された同期設定を登録解除します。設定が登録解除されると、クライアント SDK はプッシュされたデータを受信しても syncCallback 実装クラスを呼び出さなくなります。

reportMsgReceived(SyncMessage syncMessag)

syncCallback 実装クラスでデータを受信した後、この API を呼び出して、データが正常に受信されたことを MSS サーバーに通知します。サーバーが reportMsgReceived の呼び出しを受信しない場合、データの配信を再試行します。6 回再試行した後、データは完全に削除されます。

isConnected()

MSS サービスが正常に実行されているかどうかを確認します。

コード例

このサンプルは、ベースライン 10.1.32 の SDK を使用して開発されています。サンプルアプリケーションでは、ボタンをタップするとデバイス ID を取得するように設定されています。その後、コンソールはデバイス ID を使用して同期データをデバイスにプッシュします。同期 ID は bizType です。

説明

このサンプルは MSS API の呼び出し方法を示すだけであり、MSS のベストプラクティスではありません。MSS コンポーネントのベストプラクティスコードは、「コードサンプルの取得」ページからダウンロードしてください。

    public void button1Clicked(View view)
    {
        // getUtdid メソッドを使用してデバイス ID を取得します。
        String utdid =UTDevice.getUtdid(MainActivity.this);
        // Logcat に MSS データを表示します。
        Log.e("=========",utdid);
        // API と MSS サービスを初期化します。
        MPSync.initialize(MainActivity.this);
        // ビジネスデータを受信するためのコールバックを登録します。プッシュされたデータが受信されると、syncCallback が呼び出されます。
        MPSync.registerBiz("bizType",new SyncCallBackImpl());
        // サーバーとのネットワーク接続を確立します。
        MPSync.appToForeground();

    }

    public class SyncCallBackImpl implements ISyncCallback
    {
        @Override
        public void onReceiveMessage(SyncMessage syncMessage) {
            // Logcat に MSS データを表示します。
            Log.e("=========",syncMessage.msgData);
            // データが正常に受信されたことを MSS サーバーに通知します。
            MPSync.reportMsgReceived(syncMessage);
        }
    }

TLS サポート

443 以外のポートで TLS 接続を有効にするには、メタデータ mss_use_tlsmanifest ファイルに追加し、その値を YES に設定します。

image.png

説明

ポート 443 での接続は、デフォルトで TLS を使用します。

次のステップ

サーバーサイドとの統合