このページでは、Google Meet でタブを画面共有する際に、別のウェブページに簡単なコードを配置して、ユーザーにアドオンをプロモートする方法について説明します。
MeetAddonScreenshare.exposeToMeetWhenScreensharing メソッドを使用すると、サイトのタブが共有されているときに、サイトから Meet に情報を送信できるようになります。この情報は、アドオンがインストールされている場合に、ユーザーがプレゼンテーション バナーの [アクティビティを開始] をクリックしたときに、Meet のアドオン機能で使用されます。アドオンがインストールされていない状態でタブを共有すると、アドオンをインストールするよう求められます。
AddonScreenshareInfo オブジェクトには、ユースケースに応じて追加できる 5 つのフィールドがあります。
AddonScreenshareInfo.additionalData: アドオンが自身の初期化に使用できる情報。AddonScreenshareInfo.startActivityOnOpenが true で、CollaborationStartingStateを使用してアクセスできる場合にのみ設定できます。詳細については、コラボレーションの開始状態を使用するをご覧ください。AddonScreenshareInfo.cloudProjectNumber: 必須。アドオンの Google Cloud プロジェクト番号。AddonScreenshareInfo.mainStageUrl: アドオンの起動時にメインステージで開く URL（https://www.example.comなど）。この URL は、アドオン マニフェストで指定された URL と同じオリジンに属している必要があります。AddonScreenshareInfo.sidePanelUrl: アドオンの起動時にサイドパネルが開く URL（https://www.example.comなど）。この URL は、アドオン マニフェストで指定された URL と同じオリジンに属している必要があります。AddonScreenshareInfo.startActivityOnOpen: 必須。ユーザーがプレゼンテーション バナーからアドオンを起動したときに、すぐに Meet でコラボレーション アドオン エクスペリエンスを開始するかどうかを指定します。AddonScreenshareInfo.mainStageUrlを使用する場合は true にする必要があります。
例: メインステージで読み込む
次のコードサンプルでは、次のコードを含むウェブページを Meet で画面共有しているユーザーに対して、アドオンを起動するように求められます。
<script src="https://www.gstatic.com/meetjs/addons/0.7.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: 文字列。Cloud プロジェクト番号。
- MAIN_STAGE_URL: 文字列。メインステージの URL。
Meet の通話画面でユーザーがページを共有すると、Meet にプレゼンテーション バナーが表示されます。バナーのボタンをクリックすると、メインステージで特定の Cloud プロジェクト番号のアドオンが開きます。AddonScreenshareInfo.mainStageUrl が読み込まれ、AddonScreenshareInfo.additionalData を使用してアドオンのコラボレーションの開始状態が設定されます。通話中の他のユーザーは、すぐにアドオンをインストールまたは起動するよう求められます。
例: サイドパネルで読み込む
次のコードサンプルでは、ユーザーの画面が、メインステージではなくサイドパネルで開始したいアドオンとページを共有しています。
<script src="https://www.gstatic.com/meetjs/addons/0.7.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: 文字列。Cloud プロジェクト番号。
- SIDE_PANEL_URL: 文字列。サイドパネルの URL。
Meet の通話画面でユーザーがページを共有すると、Meet にプレゼンテーション バナーが表示されます。バナーのボタンをクリックすると、サイドパネルに特定の Cloud プロジェクト番号のアドオンが開きます。AddonScreenshareInfo.sidePanelUrl が読み込まれ、AddonScreenshareInfo.additionalData を使用してアドオンのコラボレーションの開始状態が設定されます。通話中の他のユーザーは、すぐにアドオンをインストールまたは起動するよう求められます。
例: コラボレーションを開始せずにサイドパネルに読み込む
次のコードサンプルでは、ユーザーの画面とアドオンが、コラボレーション アクティビティを開始する前にリソース権限を調整する必要があるページを共有しています。この要件により、アドオンはサイドパネルで開始する必要があります。ただし、すべてのユーザーのコラボレーションは開始しないでください。
<script src="https://www.gstatic.com/meetjs/addons/0.7.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: 文字列。Cloud プロジェクト番号。
- SIDE_PANEL_URL: 文字列。サイドパネルの URL。
Meet の通話画面でユーザーがページを共有すると、Meet にプレゼンテーション バナーが表示されます。バナーのボタンをクリックすると、サイドパネルに特定の Cloud プロジェクト番号のアドオンが開きます。AddonScreenshareInfo.startActivityOnOpen が false に設定されているため、CollaborationStartingState が設定されるまでアクティビティの開始ボタンは無効になります。詳しくは、コラボレーションの開始状態を使用するをご覧ください。
アクティビティが開始されると、通話に参加している他のユーザーに、アドオンを起動またはインストールするよう求めるメッセージが表示されます。
オリジン マッチング
AddonScreenshareInfo.mainStageUrl と AddonScreenshareInfo.sidePanelUrl で指定されたオリジンは、指定された Cloud プロジェクト番号のアドオン マニフェスト内のオリジンと比較されます。すべてが一致した場合、ユーザーはアドオンを起動できます。
また、画面共有を開始したサイトの提供元を、アドオン マニフェストの addOnOrigins フィールドに指定する必要があります。
詳細については、アドオンのセキュリティをご覧ください。