このページは Cloud Translation API によって翻訳されました。

画面共有を通じてアドオンをユーザーに宣伝

画面でアドオンをプロモートする
あります。

このページでは、ユーザーにアドオンを昇格させる方法について説明します画面共有しながら、Google Meet で別のウェブページ上に表示されます

exposeToMeetWhenScreensharing() メソッドを使用すると、タブが画面共有されているときに、サイトが Meet に情報を送信できます。この情報は Meet のアドオンエクスペリエンスがユーザーが [アクティビティを開始] をクリックしたときプレゼンテーションのバナーにインストールされています。お客様が共有された場合は、アドオンをインストールするよう求めるメッセージが表示されます。

AddonScreenshareInfo オブジェクトには、ユースケースに基づいて追加できる 5 つのプロパティが含まれています。

additionalData: アドオンが自身の初期化に使用できる情報。缶 startActivityOnOpen プロパティが true であり、 gcloud コマンドを使用して ActivityStartingState。詳細については、アクティビティの開始時に使用するアクティビティ確認します。
cloudProjectNumber: 必須です。Google Cloud プロジェクトのプロジェクト番号。
mainStageUrl: アドオンの起動時にメインステージで開く URL 開始（https://www.example.com など）。URL は同じものに属している必要があります origin として作成します。
sidePanelUrl: アドオンの起動時にサイドパネルが開く URL 開始（https://www.example.com など）。URL は同じものに属している必要があります origin として作成します。
startActivityOnOpen: 必須です。ユーザーがプレゼンテーションバナーからアドオンを開始したときに、Meet でアクティビティアドオンエクスペリエンスをすぐに開始するかどうか。mainStageUrl プロパティを使用する場合は true にする必要があります。

で確認できます。

例: メインステージで読み込む

次のコードサンプルでは、次のコードを含むウェブページを Meet で画面共有したユーザーに、アドオンの起動を求めるメッセージが表示されます。

<script src="https://www.gstatic.com/meetjs/addons/1.0.0/meet.addons.screenshare.js"></script>
<script>
meet.addon.screensharing.exposeToMeetWhenScreensharing(
  {
    cloudProjectNumber: CLOUD_PROJECT_NUMBER,
    startActivityOnOpen: true,
    mainStageUrl: MAIN_STAGE_URL,
    additionalData: "{\"selected_item\": \"42\"}",
  }
);
</script>

次のように置き換えます。

CLOUD_PROJECT_NUMBER: 文字列。プロジェクトのプロジェクト番号 Google Cloud プロジェクトです
MAIN_STAGE_URL: 文字列。メインステージの URL。

Meet の通話画面でユーザーがページを共有すると、共有できるようになりました。バナーのボタンをクリックすると指定した Cloud プロジェクト番号のアドオンを行います。mainStageUrl プロパティが読み込まれ、additionalData プロパティを使用してアドオンのアクティビティの開始状態が設定されます。通話中の他のユーザーは、すぐにアドオンのインストールまたは起動を求めるメッセージが表示されます。

例: サイドパネルに読み込む

次のコードサンプルでは、ユーザーの画面がサイドパネルから開始したいアドオンを避けるということです。

<script src="https://www.gstatic.com/meetjs/addons/1.0.0/meet.addons.screenshare.js"></script>
<script>
meet.addon.screensharing.exposeToMeetWhenScreensharing(
  {
    cloudProjectNumber: CLOUD_PROJECT_NUMBER,
    startActivityOnOpen: true,
    sidePanelUrl: SIDE_PANEL_URL,
    additionalData: "{\"selected_item\": \"42\"}",
  }
);
</script>

次のように置き換えます。

CLOUD_PROJECT_NUMBER: 文字列。プロジェクトのプロジェクト番号できます。
SIDE_PANEL_URL: 文字列。サイドパネルの URL。

Meet の通話画面でユーザーがページを共有すると、共有できるようになりました。バナーのボタンをクリックすると指定した Cloud プロジェクト番号のアドオンをアクセスできます。sidePanelUrl プロパティが読み込まれ、 additionalData プロパティを使用して、開始するアクティビティを設定する状態を定義します。通話中の他のユーザーは、すぐにアドオンのインストールまたは起動を求めるメッセージが表示されます。

例: アクティビティを開始せずにサイドパネルを読み込む

次のコードサンプルでは、ユーザーの画面がリソース権限を調整する必要があります。アクティビティを開始できます。この要件により、サイドパネルで開始する必要があり、開始しました。

<script src="https://www.gstatic.com/meetjs/addons/1.0.0/meet.addons.screenshare.js"></script>
<script>
meet.addon.screensharing.exposeToMeetWhenScreensharing(
  {
    cloudProjectNumber: CLOUD_PROJECT_NUMBER,
    startActivityOnOpen: false,
    sidePanelUrl: SIDE_PANEL_URL,
  }
);
</script>

次のように置き換えます。

CLOUD_PROJECT_NUMBER: 文字列。プロジェクトのプロジェクト番号できます。
SIDE_PANEL_URL: 文字列。サイドパネルの URL。

Meet の通話画面でユーザーがページを共有すると、共有できるようになりました。バナーのボタンをクリックすると指定した Cloud プロジェクト番号のアドオンをアクセスできます。以降、 startActivityOnOpen プロパティが false に設定されると、[アクティビティを開始] ボタンが ActivityStartingState が設定されました。詳細については、アクティビティを使用する開始状態。

アクティビティが開始されると、通話の他のユーザーに、アドオンを起動またはインストールします。

オリジンマッチング

mainStageUrl プロパティと sidePanelUrl プロパティで指定されたオリジンは、指定された Cloud プロジェクト番号のアドオンマニフェストのオリジンと比較されます。すべて一致した場合、ユーザーはアドオンの起動が許可されています。

また、画面共有を開始したサイトの提供元も記載する必要があります。アドオンの addOnOrigins フィールド定義できます。

詳細については、アドオンのセキュリティをご覧ください。

画面共有を通じてアドオンをユーザーに宣伝

例: メインステージで読み込む

例: サイドパネルに読み込む

例: アクティビティを開始せずにサイドパネルを読み込む

オリジン マッチング

関連トピック

オリジンマッチング