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

Ekrandan eklenti tanıtımı paylaşım.

Bu sayfada, bir eklentinin kullanıcılara nasıl tanıtılacağı açıklanmaktadır. Google Meet ile ekran paylaşımı sırasında küçük miktarda kod yerleştirerek başka bir web sayfasında görebilirsiniz.

İlgili içeriği oluşturmak için kullanılan exposeToMeetWhenScreensharing() yöntemi, sitenin Meet'e bilgi göndermesine olanak tanır . Bu bilgiler, Meet'teki eklenti deneyimini Kullanıcı "Etkinliği başlat"ı tıklar ekranda içeriği varsa yüklü olduğundan emin olun. Kullanıcı bir sekme paylaşımında bulunduğunda, eklentiyi yüklemeniz istenir.

İlgili içeriği oluşturmak için kullanılan AddonScreenshareInfo nesne, kullanım alanına göre eklenebilecek beş özellik içerir:

  • additionalData: Eklentinin kendini başlatmak için kullanabileceği bilgiler. Teneke Kutu yalnızca startActivityOnOpen özelliği doğruysa ve ActivityStartingState Daha fazla bilgi için Etkinliği, durum.

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

  • mainStageUrl: Eklenti yüklendikten sonra ana aşamanın açılacağı URL (ör. https://www.example.com) başlar. URL, origin olacak şekilde manifest dosyasıdır.

  • sidePanelUrl: Eklenti yüklendiğinde yan panelin açtığı URL (ör. https://www.example.com) başlar. URL, origin olacak şekilde manifest dosyasıdır.

  • startActivityOnOpen: Zorunludur. Etkinlik eklentisinin başlatılıp başlatılmayacağı kullanıcı Meet'te simgesini tıklayın. Doğru olmalıdır mainStageUrl özelliği kullanılır.

ziyaret edin.

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

SDK'ya npm veya gstatic kullanarak erişebilirsiniz.

Projenizde npm kullanılıyorsa Eklenti SDK'sı npm paketiyle tanışın.

Öncelikle npm paketini yükleyin:

npm install @googleworkspace/meet-addons

Ardından, MeetAddonScreenshareExport arayüz:

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 aşağıdaki komut dosyası etiketini uygulama:

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

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

Örnek: Ana ekranda yükleme

Aşağıdaki kod örneğinde, bir web sayfasını şurada paylaşan bir kullanıcı: Aşağıdaki kodu içeren Meet, eklenti:

<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. Proje numarası: Google Cloud projesi.
  • MAIN_STAGE_URL: Dize. Ana sahnenin URL'si.

Meet görüşmesi ekranındaki kullanıcı sayfayı paylaştığında Meet'teki sunu banner'ı. Banner'daki düğmeyi tıklayarak belirtilen bulut projesi numarası için eklentiyi açılır. en önemli şeydir. mainStageUrl özelliği yüklenir ve additionalData özelliği, başlayacak etkinliği ayarlamak için kullanılır durumu gösterir. Görüşmedeki diğer kullanıcılar eklentiyi hemen yüklemenizi veya başlatmanızı ister.

Örnek: Yan panelde yükleme

Aşağıdaki kod örneğinde bir kullanıcı ekranı, sadece yan panelden başlamak isteyen daha fazla bilgi sağlar:

<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. Proje numarası: Cloud projesi.
  • SIDE_PANEL_URL: Dize. Yan panelin URL'si.

Meet görüşmesi ekranındaki kullanıcı sayfayı paylaştığında Meet'teki sunu banner'ı. Banner'daki düğmeyi tıklayarak belirtilen bulut projesi numarası için eklentiyi açılır. yan paneli açın. sidePanelUrl özelliği yüklenir ve additionalData özelliği, başlayacak etkinliği ayarlamak için kullanılır durumu gösterir. Görüşmedeki diğer kullanıcılar eklentiyi hemen yüklemenizi veya başlatmanızı ister.

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

Aşağıdaki kod örneğinde bir kullanıcı ekranı, başlamadan önce kaynak izinlerini ayarlaması gereken etkinlik başlatılabilir. Bu şarttan dolayı, eklentisi, yan panelde, bir etkinlik olduğunu varsayalım.

<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. Proje numarası: Cloud projesi.
  • SIDE_PANEL_URL: Dize. Yan panelin URL'si.

Meet görüşmesi ekranındaki kullanıcı sayfayı paylaştığında Meet'teki sunu banner'ı. Banner'daki düğmeyi tıklayarak belirtilen bulut projesi numarası için eklentiyi açılır. yan paneli açın. startActivityOnOpen özelliği false olarak ayarlandığında, etkinliği başlatma düğmesi ActivityStartingState ayarlandı. Daha fazla bilgi için Etkinliği kullanma başlangıç durumunu ekleyebilirsiniz.

Etkinlik başladıktan sonra, görüşmedeki diğer kullanıcılardan veya yüklemeyi etkinleştirmeniz gerekir.

Kaynak eşleştirme

Şurada sağlanan kaynaklar: mainStageUrl ve sidePanelUrl özellikleri, eklentideki kaynaklarla karşılaştırıldığında manifestosunu oluşturun. Her şey eşleşiyorsa kullanıcı eklentisini başlatmasına izin verilir.

Ayrıca, ekran paylaşımını başlatan sitenin kaynağı da listelenmelidir. eklentideki addOnOrigins alanında manifest dosyasındaki talimatları uygulayın.

Daha fazla bilgi için Eklenti güvenlik.