now.gg イベントモジュール

Unity の now.gg イベント モジュールを使用すると、開発者は埋め込みゲームが実行されている Web サイトにアプリからコマンド/イベントを送信することで、now.gg クラウド上のアプリを簡単に制御できます。

下記手順でnow.ggイベントモジュールを実装します。

  • now.ggイベントモジュールをダウンロートしてインポートします
  • now.ggイベントモジュールを使用する

1. プラグインのダウンロードとインポート

now.ggイベントモジュールは Unityパッケージファイル- nowgg-events.unitypackageとして含まれています。

プラグインをUnityプロジェクトに追加

  1. now.ggイベントモジュールプラグイン for Unityの最新バージョンを含むパッケージをダウンロードします
  2. プラグインのダウンロードが完了したら、プロジェクトにインポートします
    手順:

    • 下記のようにAssets > Import Package > Custom Packageとクリック
    • ダウンロードしたパッケージ内のModules > Eventsディレクトリをブラウズ
    • nowgg-events.unitypackage ファイルを選択.
    • リストされたファイルをすべて選択して、Importをクリック.

すべてのプラグインファイルがインポートされると、’NowGGSdk‘という名前のフォルダがプロジェクトに追加されます。このフォルダはAssetsフォルダのルートにあります。

注意:now.ggイベントモジュールに関連するすべてのアセットが含まれているため、NowGGSdk フォルダを編集しないでください。


2. now.gg イベントモジュールの使用

now.gg イベントモジュールがインポートされると、コマンドとイベントをAndroidアプリやゲームに送信できるようになります。

実装の参考として、コマンドとイベントのサンプルをいくつか用意しました。

下記に示すようにNowGGEventsSdkManager クラスをイベントをトリガーするために使用することができます。

1. URLを開く

NowGGEventsSDKManagerクラスのOpenURL関数を呼ぶと、下記のように指定された URL を新しいブラウザウィンドウで開くことができます。

string url = "https://example.com";

 NowGGEventsSdkManager.Instance.OpenURL(url);

参照 OpenURL()に関連する追加情報は、「参考資料」セクションにあります。

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

必要なパラメータと共にNowGGEventsSDKManagerクラスのSendEventToBrowser関数を呼び出すことで、イベントとデータを HTML ページに送信し、そこで処理することができます。

a. HTMLページにイベントを送信する
string eventName = "test-event";
 string eventData = "test-data";

 NowGGEventsSdkManager.Instance.SendEventToBrowser(eventName, eventData);

参照 SendEventToBrowser()に関連する追加情報は、「参考資料」セクションにあります。

b. HTMLページでイベントを処理する

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

const eventCallbackFunction = (event) => {
   console.log(event.eventName); // event1
   console.log(event.eventData); // eventData1
  
   // Perform event-based handling here
 }; 

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

HTMLページからAndroidアプリに送信されたアプリ起動データを取得するには、以下の2つの方法があります。

a. ディクショナリを使用してすべての起動データパラメータを取得する

下記のようにNowGGEventsSdkManagerクラスの GetAppLaunchDataDictionary()関数を呼び出すことができます。

//Retrieves a dictionary of all app launch data params

 Dictionary<string, string> AppLaunchData = NowGGEventsSdkManager.Instance.GetAppLaunchDataDictionary(); 

参照 GetAppLaunchDataDictionary() に関連する追加情報は、「参考資料」セクションにあります。

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

下記のように、プロパティ名と共にNowGGEventsSdkManagerGetAppLaunchDataProperty() 関数を呼び出すことで、特定のアプリ起動データパラメータを取得することができます。

///Retrieves an app launch data property by name parameters

 string property = NowGGEventsSdkManager.Instance.GetAppLaunchDataProperty("property_name");

参照GetAppLaunchDataProperty() に関連する追加情報は、「参考資料」セクションにあります。

×
テキストがクリップボードにコピーされました。
copyLinkText
ご不明な点がございましたら、お気軽にお問い合わせください。 dev-support@now.gg