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

Bu sayfada, Google Meet ile bir sekmeyi ekran paylaşımı yaparken başka bir web sayfasına küçük bir kod yerleştirerek kullanıcılara bir eklentinin nasıl tanıtılacağı açıklanmaktadır.

MeetAddonScreenshare.exposeToMeetWhenScreensharing yöntemi, sekmesi ekran paylaşıldığında sitenin Meet'e bilgi göndermesine olanak tanır. Bu bilgiler, eklenti yüklüyse sunu banner'ında "Etkinliği başlat"ı tıklayan kullanıcı Meet'teki eklenti deneyiminde kullanılır. Bir sekmeyi paylaştığında kullanıcıdan eklenti yüklü değilse kullanıcıdan eklentiyi yüklemesi istenir.

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

• AddonScreenshareInfo.additionalData: Eklentinin kendini başlatmak için kullanabileceği bilgiler. Yalnızca AddonScreenshareInfo.startActivityOnOpen doğru ise ve CollaborationStartingState kullanılarak erişilebilirse ayarlanabilir. Daha fazla bilgi için Ortak çalışma başlangıç durumunu kullanma bölümüne bakın.

• AddonScreenshareInfo.cloudProjectNumber: Zorunlu. Eklentinin Google Cloud proje numarası.

• AddonScreenshareInfo.mainStageUrl: Eklenti başlatıldığında ana aşamanın açılacağı https://www.example.com gibi URL. URL, eklenti manifestinde belirtilen URL'lerle aynı kaynağa ait olmalıdır.

• AddonScreenshareInfo.sidePanelUrl: Eklenti başlatıldığında yan panelin açılan URL'sidir (ör. https://www.example.com). URL, eklenti manifestinde belirtilen URL'lerle aynı kaynağa ait olmalıdır.

• AddonScreenshareInfo.startActivityOnOpen: Zorunlu. Kullanıcı eklentiyi sunu banner'ından başlattığında Meet'te ortak çalışmaya dayalı eklenti deneyiminin hemen başlatılıp başlatılmayacağı. AddonScreenshareInfo.mainStageUrl kullanılıyorsa doğru olmalıdır.

Örnek: Ana ekranda yükleme

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

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

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

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

Örnek: Yan panelde yükleme

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

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

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

• CLOUD_PROJECT_NUMBER: Dize. Bulut 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, yan panelde belirtilen bulut projesi numarası için eklenti açılır. AddonScreenshareInfo.sidePanelUrl yüklenir ve eklentinin ortak çalışma başlangıç durumunu ayarlamak için AddonScreenshareInfo.additionalData 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 eklentinin bulunduğu bir sayfayı paylaşır. Bu gereklilik nedeniyle, eklenti, herkes için ortak çalışma başlatılmadan yan panelde başlatılmalıdır.

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

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

• CLOUD_PROJECT_NUMBER: Dize. Bulut 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, yan panelde belirtilen bulut projesi numarası için eklenti açılır. AddonScreenshareInfo.startActivityOnOpen yanlış değerine ayarlandığından, CollaborationStartingState ayarlanana kadar etkinliği başlatma düğmesi devre dışıdır. Daha fazla bilgi için Ortak çalışma başlangıç durumunu kullanma bölümüne bakın.

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

Kaynak eşleştirme

AddonScreenshareInfo.mainStageUrl ve AddonScreenshareInfo.sidePanelUrl bölümlerinde sağlanan kaynaklar, sağlanan bulut projesi numarasının eklenti manifestindeki kaynaklarla karşılaştırılır. Her şey eşleşiyorsa 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.

İlgili konular

• Ortak çalışma başlangıç durumunu kullanma
• Eklenti güvenliği