このトピックでは、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 つのステップで構成されます。
前提条件
プロジェクトが mPaaS と統合されていること。
ネイティブ AAR ベースの統合の場合、プロジェクトに 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(Context context) | API と MSS サービスを初期化します。 |
appToForeground() | アプリが起動されたことをクライアント SDK に通知し、サーバーとのネットワーク接続を確立します。アプリがフォアグラウンドに表示されるたびに、このメソッドを呼び出してください。 |
appToBackground() | アプリがバックグラウンドに移行したことをクライアント SDK に通知し、サーバーから切断します。アプリがバックグラウンドに移行するたびに、このメソッドを呼び出してください。 |
updateUserInfo(String sessionId) | userId や sessionId などのログイン情報が変更されたときに、このメソッドを呼び出します。このメソッドは少なくとも 1 回は呼び出す必要があります。 |
clearUserInfo() | ユーザーをログアウトします。 |
registerBiz(String bizType, ISyncCallback syncCallback) | ビジネスデータを受信するための |
unregisterBiz(String bizType) | 指定された同期設定を登録解除します。設定が登録解除されると、クライアント SDK はプッシュされたデータを受信しても |
reportMsgReceived(SyncMessage syncMessag) |
|
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_tls を manifest ファイルに追加し、その値を YES に設定します。

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