Embed SDKのインテグレーション

このセクションでは now.gg Embed SDKを統合する手順を説明します。

now.gg Embed SDKの統合方法:

  1. Embed SDK をウェブサイトに追加します
  2. Iframe内でゲームを開始します
  3. さらに次のセクションで、高度な機能を埋め込んで統合する手順を説明します

重要な情報

  • ゲームがテストまたは本番トラックにデプロイされ、埋め込み用のゲームリンクがあることを確認してください。
  • 以下のリンクから、リリースを作成し、アプリをデプロイすることができます。

1. Embed SDKの追加

最初のステップは対象のウェブサイトにEmbed SDKを追加することです。

now.gg Embed SDKをウェブサイトに追加するには、以下に示すようにSDKリソースのjavascriptをscriptタグ内に追加します。

<script type="text/javascript" src="https://cdn.now.gg/external/sdk/ifp-sdk-1.0.0.min.js"></script>

2. Iframe内でゲームを開始する

now.gg Embed SDK リソースを追加すると、SDKを初期化することでnow.gg iframe を使用したゲームをウェブサイトに埋め込むことができます。

手順は以下の通りです。

  • まず、iframeParentElementappEventCallbackFunctionsdkEventCallbackFunction. を定義します。.
  • 次に以下に示すようにNowIfpクラスのinit関数をクラウドゲームを開始するために必要なパラメータと共にコールします。
const iframeParentElement = document.getElementById("your_iframe_element");

 // Callback function to handle events sent from the Android app.
 const appEventCallbackFunction = (event) => {
     console.log(event.name); 
     console.log(event.data);
     // can do your event-based handling here
 }; 

 // Callback function to handle javascript SDK events.
 const sdkEventCallbackFunction = (event) => {
     console.log(event.name); 
     console.log(event.msg);
     // can do your event-based handling here
 }; 


 NowIfp.init({
     clientId: <"your_clientId"> ,
     appId: <"your_production_appId/your_test_track_appId"> , \\ appId example - Test Track: "1234_t1" | Production: "1234"
     iframeParentElement: iframeParentElement,
     customData: {} // for app-specific custom handling
     appLaunchData: {
         [key]: [value]
     } // pass launch arguments to Iframe, It will be serialized and passed to the app at launch intent.
     appEventCallback: appEventCallbackFunction,
     sdkEventCallback: sdkEventCallbackFunction,
 });

appIdを取得する

このセクションを使用して、nowStudio内でappIdを見つけることができます。

重要な情報

  • appIdは、nowStudio上のアプリの固有の識別子です。
  • nowStudioは、テスト環境と本番環境で異なるappIdを生成します。
    • テストトラック:appIdは、アプリがデプロイされた後にのみ表示されます。
    • 本番用:appIdは、アプリを追加した後「アプリの詳細」セクションでも確認できます。
1. テストトラック用のappID
  • テストトラック用にappIDを見つける方法:
  • 全アプリ > アプリを選択 > テストトラックに移動します。
    • appIdは、以下のようにライブテストリリースに記載されています。
2. 本番用のappID
  • 本番用にappIDを見つける方法:
  • 全アプリ > アプリを選択 > リリースに移動します。
    • appIdは、以下のように本番リリースに記載されています。

パラメータ

パラメータ 必須項目 説明
clientId string はい 一意のクライアント識別子
appId string はい now.gg開発者ポータルでアプリ/ゲームに関連付けられたアプリID
iframeParentElement element はい embeddedプレーヤがレンダリングされるiframeParentElement
customData object いいえ 特定の処理を必要とするカスタムデータ
appLaunchData object いいえ アプリの起動インテントエクストラとして送信される追加データ
参照 – appLaunchDataを定義する セクション
appEventCallback function No アプリ関連のイベントを処理するためのアプリイベントコールバック関数
参照 – embed内でゲームを開始する セクション-
sdkEventCallback function No SDK関連イベント処理用SDKイベントコールバック関数
参照 – Iframe内でゲームを開始する セクション

now.gg クラウドによってゲームが対象のウェブページに埋め込まれました。

さらに、高度な機能の埋め込みを実装する場合は 次のセクションに進んでください。

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