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

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 kendisini 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.

npm install @googleworkspace/meet-addons

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

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

Ö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.

GitHub'daki "Animasyon" örnek eklentisi, bu örneği 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 ilgili 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ığı 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. 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 için Ek güvenlik başlıklı makaleyi inceleyin.

İlgili konular

• Meet eklentisi kullanarak ortak çalışma
• Eklenti güvenliği