Ekran paylaşımı aracılığıyla bir eklentiyi kullanıcılara tanıtma

Ekran paylaşımı üzerinden eklenti tanıtımı

Bu sayfada, başka bir web sayfasına az miktarda kod yerleştirerek Google Meet ile bir sekmeyi ekran paylaşırken kullanıcılara eklenti tanıtmanın nasıl yapılacağı açıklanmaktadır.

exposeToMeetWhenScreensharing() yöntemi, sekmesi ekranda paylaşıldığında sitenin Meet'e bilgi göndermesine olanak tanır. Bu bilgiler, eklenti yüklüyse kullanıcı sunu banner'ında "Etkinliği başlat"ı tıkladığında Meet eklentisi deneyiminde kullanılır. Kullanıcı, sekme ekranını paylaşırken eklentiyi yüklemediyse eklentiyi yüklemesi istenir.

AddonScreenshareInfo nesnesi, kullanım alanına göre eklenebilecek beş özellik içerir:

  • additionalData: Eklentinin kendini başlatmak için kullanabileceği bilgiler. Yalnızca startActivityOnOpen özelliği doğruysa ve ActivityStartingState kullanılarak erişilebiliyorsa ayarlanabilir. Daha fazla bilgi için Etkinliği başlatma durumunu alma başlıklı makaleyi inceleyin.

  • cloudProjectNumber: Zorunlu. Google Cloud projenizin proje numarası.

  • mainStageUrl: Eklenti başladıktan sonra ana sahnenin açtığı URL (ör. https://www.example.com). URL, eklenti manifest'inde belirtilen URL'lerle aynı kaynak alanına ait olmalıdır.

  • sidePanelUrl: Eklenti başladığında yan panelin açtığı URL (ör. https://www.example.com). URL, eklenti manifest'inde belirtilen URL'lerle aynı kaynak alanına ait olmalıdır.

  • startActivityOnOpen: Zorunlu. Kullanıcı sunu banner'ından eklentiyi başlattığında Meet'te etkinlik eklentisi deneyiminin hemen başlatılıp başlatılmayacağı. mainStageUrl özelliği kullanılıyorsa doğru olmalıdır.

SDK'yı yükleme ve içe aktarma

SDK'ya npm veya gstatic kullanarak erişebilirsiniz.

Projenizde npm kullanılıyorsa Meet Eklentileri SDK'sı npm paketi ile ilgili talimatları uygulayabilirsiniz.

Öncelikle npm paketini yükleyin:

npm install @googleworkspace/meet-addons

Ardından, Meet Eklentileri SDK'sını kullanmak için MeetAddonScreenshareExport arayüzünü içe aktarın:

import {meet} from '@googleworkspace/meet-addons/meet.addons.screenshare';

TypeScript kullanıcıları için TypeScript tanımları modülle birlikte paketlenir.

gstatic

Google Meet Eklentileri SDK'sı, statik içerik sunan bir alan olan gstatic adresinden JavaScript paketi olarak kullanılabilir.

Meet Eklentileri SDK'sını kullanmak için uygulamanıza aşağıdaki komut dosyası etiketini ekleyin:

<script src="https://www.gstatic.com/meetjs/addons/1.1.0/meet.addons.screenshare.js"></script>

Meet Eklentileri SDK'sı, window.meet.addon altındaki MeetAddon arayüzünden kullanılabilir.

Örnek: Etkinlik başlatmadan yan panele yükleme

Aşağıdaki kod örneğinde, bir kullanıcı ekranı, etkinliğin başlatılabilmesi için kaynak izinlerini ayarlaması gereken bir eklentinin bulunduğu bir sayfayı paylaşmaktadır. Bu şart nedeniyle, eklenti yan panelde başlatılmalı ve etkinlik herkes için başlatılmamalıdır.

<script>
meet.addon.screensharing.exposeToMeetWhenScreensharing(
  {
    cloudProjectNumber: CLOUD_PROJECT_NUMBER,
    startActivityOnOpen: false,
    sidePanelUrl: SIDE_PANEL_URL,
  }
);
</script>

Aşağıdakini değiştirin:

  • CLOUD_PROJECT_NUMBER: Dize. Cloud projenizin proje numarası.
  • SIDE_PANEL_URL: Dize. Yan panelin URL'si.

Meet görüşmesi ekranındaki kullanıcı sayfayı paylaştığı zaman Meet'te bir sunu banner'ı görür. Banner'daki düğmeyi tıkladığınızda, yan panelde ilgili bulut projesi numarasının eklentisi açılır. startActivityOnOpen mülkü false olarak ayarlandığından, ActivityStartingState ayarlanana kadar etkinlik başlat düğmesi devre dışıdır. Daha fazla bilgi için Etkinlik başlangıç durumunu kullanma başlıklı makaleyi inceleyin.

Etkinlik başladıktan sonra görüşmedeki diğer kullanıcılardan eklentiyi başlatmaları veya yüklemeleri istenir.

Bu örneği, GitHub'daki "Animasyon" örnek eklentisi tam bir eklentinin parçası olarak içerir. Eklenti ile ilişkili web uygulamasının dizin sayfası gösterildiğinde, sunan kullanıcıdan eklentiyi yüklemesi veya kurması istenir.

Örnek: Ana sahneye yükleme

Aşağıdaki kod örneğinde, Meet'te aşağıdaki kodu içeren bir web sayfasını ekranı paylaşan kullanıcıdan eklentiyi başlatması istenir:

<script>
meet.addon.screensharing.exposeToMeetWhenScreensharing(
  {
    cloudProjectNumber: CLOUD_PROJECT_NUMBER,
    startActivityOnOpen: true,
    mainStageUrl: MAIN_STAGE_URL,
    additionalData: "{\"selected_item\": \"42\"}",
  }
);
</script>

Aşağıdakini değiştirin:

  • CLOUD_PROJECT_NUMBER: Dize. Google Cloud projenizin proje numarası.
  • MAIN_STAGE_URL: Dize. Ana sahnenin URL'si.

Meet görüşmesi ekranındaki kullanıcı sayfayı paylaştığı zaman Meet'te bir sunu banner'ı görür. Banner'daki düğmeyi tıkladığınızda, ana sahnede belirli bir bulut projesi numarasının eklentisi açılır. mainStageUrl özelliği yüklenir ve eklentinin etkinlik başlangıç durumunu ayarlamak için additionalData özelliği kullanılır. Görüşmedeki diğer kullanıcılardan hemen eklentiyi yüklemeleri veya başlatmaları istenir.

Örnek: Yan panele yükleme

Aşağıdaki kod örneğinde, kullanıcı ekranında ana sahne yerine yan panelde başlamak isteyen bir eklentinin bulunduğu bir sayfa paylaşılmaktadır:

<script>
meet.addon.screensharing.exposeToMeetWhenScreensharing(
  {
    cloudProjectNumber: CLOUD_PROJECT_NUMBER,
    startActivityOnOpen: true,
    sidePanelUrl: SIDE_PANEL_URL,
    additionalData: "{\"selected_item\": \"42\"}",
  }
);
</script>

Aşağıdakini değiştirin:

  • CLOUD_PROJECT_NUMBER: Dize. Cloud projenizin proje numarası.
  • SIDE_PANEL_URL: Dize. Yan panelin URL'si.

Meet görüşmesi ekranındaki kullanıcı sayfayı paylaştığında Meet'te bir sunu banner'ı görür. Banner'daki düğmeyi tıkladığınızda, yan panelde ilgili bulut projesi numarasının eklentisi açılır. sidePanelUrl özelliği yüklenir ve eklentinin etkinlik başlangıç durumunu ayarlamak için additionalData özelliği kullanılır. Görüşmedeki diğer kullanıcılardan hemen eklentiyi yüklemeleri veya başlatmaları istenir.

Kaynak eşleştirme

mainStageUrl mülkü ve sidePanelUrl mülkünde sağlanan kökenler, sağlanan bulut proje numarasının eklenti manifestindeki kökenlerle karşılaştırılır. Her şey eşleşirse kullanıcının eklentiyi başlatmasına izin verilir.

Ayrıca, ekran paylaşımını başlatan sitenin kaynağı, eklenti manifest dosyasında addOnOrigins alanında listelenmelidir.

Daha fazla bilgi edinmek için Eklenti güvenliği bölümünü inceleyin.