Events Module for Native Android

このセクションでは、now.gg Eventsモジュールを開発環境に統合する手順を説明します。

まず、now.gg Eventsモジュールを含むnow.gg SDKダウンロードパッケージをダウンロードし、開発環境に追加します。

SDKライブラリの追加

まず、Eventsモジュールライブラリを含むnow.gg SDKパッケージをダウンロードし、以下の手順に従って開発環境に追加します：

注意: now.gg SDKパッケージには、Eventsモジュールとサンプルコードが含まれています。

1. 抽出 圧縮されたnow.gg Eventsモジュールを解凍し、パッケージ内の.aarファイルを見つけます：

 Events.aar

2. 追加 ゲームのbuild.gradleファイルに次の依存関係を追加します：

dependencies {
         implementation fileTree(dir: 'libs', include: ['*.aar'])
 }

Eventsモジュールの使用

モジュールが正常にインポートされたら、now.gg Eventsモジュールを使用することができます。
実装の参考として、コマンド/イベントのサンプルをいくつか用意しています。
以下の例に示すように、NowGGEventsSdkManagerクラスを使用してイベントをトリガーできます：

1. イベントとデータをHTMLページに送信

NowGGEventsSdkManagerクラスのsendEventToBrowser関数と必要なパラメータを使用して、イベントとデータをHTMLページに送信し、そこで処理します。

a. HTMLページへのイベント送信

string eventName = "test-event";
 string eventData = "test-data";
 NowGGEventsSdkManager.getInstance().sendEventToBrowser(eventName, eventData, activityContext);

参考 – sendEventToBrowser()に関連する追加情報はこちらで確認できます。

b. HTMLページでのイベント処理

データがHTMLに送信された後、以下のように、そこでデータを処理することができます:

const eventCallbackFunction = (event) => {
 console.log(event.eventName); // event1
 console.log(event.eventData); // eventData1

 // イベントベースの処理をここで実行
 };

2. アプリでの起動データの取得

HTMLページからAndroidアプリに送信されたアプリ起動データを取得するための2つのメソッドを提供しています。

a. バンドルを使用してすべてのアプリ起動データパラメータを取得

以下の例に示すように、NowGGEventsSdkManagerクラスのgetAppLaunchDataBundle関数を呼び出すことができます：

 //すべてのアプリ起動データパラメータのバンドルを取得
 Bundle bundle = NowGGEventsSdkManager.getInstance().getAppLaunchDataBundle(activityContext);

参考 – getAppLaunchDataBundle()に関連する追加情報はこちらで確認できます。

b. プロパティ名を使用して特定のアプリ起動データパラメータを取得

以下の例に示すように、プロパティ名と共にgetAppLaunchDataProperty()関数を呼び出して、特定のアプリ起動データパラメータを取得できます。

 //プロパティ名でアプリ起動データを取得
 String property = NowGGEventsSdkManager.getInstance().getAppLaunchDataProperty("event_name", activityContext);

注意: プロパティが見つからない場合、空の文字列が返されます。
参考 – getAppLaunchDataProperty()に関連する追加情報はこちらで確認できます。

統合の開始

リファレンス