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

Ekran paylaşımı yoluyla bir eklentiyi
tanıtmak.

Bu sayfada, Google Meet'te ekran paylaşırken başka bir web sayfasına az miktarda kod yerleştirerek kullanıcılara bir eklentinin nasıl tanıtılacağı açıklanmaktadır.

MeetAddonScreenshare.exposeToMeetWhenScreensharing yöntemi, sitenin sekmesi ekran paylaşıldığında Meet'e bilgi göndermesine olanak tanır. Bu bilgiler, Meet eklenti deneyiminde, eklenti yüklüyse kullanıcı sunu banner'ındaki "Etkinlik başlat"ı tıkladığında kullanılır. Ekranında bir sekmeyi paylaşan kullanıcı, ilgili eklentiyi yüklemediyse eklentiyi yüklemeleri istenir.

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

Örnek: Ana sahnede yükleme

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

<script src="https://www.gstatic.com/meetjs/addons/0.1.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>

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

  • CLOUD_PROJECT_NUMBER: Dize. Cloud proje numaranız.
  • MAIN_STAGE_URL: Dize. Ana sahnenin 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, ana aşamada belirtilen bulut projesi numarası için eklenti açılır. AddonScreenshareInfo.mainStageUrl yüklenir ve AddonScreenshareInfo.additionalData, eklentinin ortak çalışma başlangıç durumunu ayarlamak için kullanılır. Görüşmedeki diğer kullanıcılardan hemen eklentiyi yüklemeleri veya başlatmaları istenir.

Örnek: Yan panelden yükleme

Aşağıdaki kod örneğinde, bir kullanıcı ekranı, ana sahne yerine yan panelde başlatmak isteyen bir eklenti içeren bir sayfa paylaşmaktadır:

<script src="https://www.gstatic.com/meetjs/addons/0.1.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>

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

  • CLOUD_PROJECT_NUMBER: Dize. Cloud proje numaranız.
  • 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, ilgili bulut projesi numarası için eklenti yan panelde açılır. AddonScreenshareInfo.sidePanelUrl yüklenir ve AddonScreenshareInfo.additionalData, eklentinin ortak çalışma başlangıç durumunu ayarlamak için kullanılır. Görüşmedeki diğer kullanıcılardan hemen eklentiyi yüklemeleri veya başlatmaları istenir.

Örnek: Ortak çalışma başlatmadan yan panelde yükleme

Aşağıdaki kod örneğinde kullanıcı ekranı, ortak çalışma etkinliğinin başlatılabilmesi için kaynak izinlerini ayarlaması gereken bir eklenti içeren sayfa paylaşır. Bu gereksinim nedeniyle, ortak çalışma herkes için başlatılmadan eklentinin yan panelde başlatılması gerekir.

<script src="https://www.gstatic.com/meetjs/addons/0.1.0/meet.addons.screenshare.js"></script>
<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 proje numaranız.
  • 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, ilgili bulut projesi numarası için eklenti yan panelde açılır. AddonScreenshareInfo.startActivityOnOpen yanlış değerine ayarlandığından, etkinliği başlat düğmesi CollaborationStartingState ayarlanana kadar devre dışıdır. Daha fazla bilgi için Ortak çalışma başlangıç durumunu kullanma bölümüne bakın.

Etkinlik başlatıldığında, görüşmedeki diğer kullanıcılardan eklentiyi başlatmaları veya yüklemeleri istenir.

Kaynak eşleştirme

AddonScreenshareInfo.mainStageUrl ve AddonScreenshareInfo.sidePanelUrl için sağlanan kaynaklar, sağlanan bulut proje numarasının eklenti manifestindeki kaynaklarla 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 manifestindeki addOnOrigins alanında listelenmelidir.

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