Kullanıcılara eklenti tanıtma

Geliştiriciler, Meet'in arama içi sohbeti ve Meet'in ekran paylaşımı özelliği aracılığıyla tanıtım yaparak eklentilerinin keşfedilme oranını artırabilir.

Görüşme sırasında sohbet

Bir mesajda eklentiyle ilişkili bağlantılar varsa Google Meet eklentileri, görüşme içi sohbet özelliğinde kullanıcılara otomatik olarak tanıtılır. Geliştiricinin, sohbetlerde eklentileri tanıtmak için herhangi bir işlem yapması gerekmez. İnceleme ekibi, yan panel URI'sine ve deployment manifest içinde ayarlanan eklenti kaynaklarına göre hangi bağlantıların bir eklentiyle ilişkilendirileceğini belirler.

Kullanıcılar, bir eklentiyle ilişkili görüşme içi sohbet üzerinden mesaj gönderdiğinde iki durumdan biri gerçekleşir:

1. Eklenti yüklü değilse kullanıcıdan eklentiyi yüklemesini isteyen bir kart gösterilir.
2. Eklenti zaten yüklüyse kullanıcıya eklentiyi açmasını hatırlatan bir düğme gösterilir.

Ekran paylaşımı

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

exposeToMeetWhenScreensharing() yöntemi, sekmesi ekran paylaşımı yapıldığında sitenin Meet'e bilgi göndermesine olanak tanır. Bu bilgiler, kullanıcı eklentiyi yüklediyse sunum banner'ında "Etkinliği başlat"ı tıkladığında Meet ile eklenti deneyiminde kullanılır. Kullanıcı, sekme paylaşımı yaparken eklenti yüklü değilse 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 ayarlanabilir ve ActivityStartingState kullanılarak erişilebilir. Daha fazla bilgi için Etkinliğin başlangıç durumunu alma başlıklı makaleye bakın.

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

• mainStageUrl: Eklenti başlatıldıktan sonra ana sahnenin açıldığı URL (ör. https://www.example.com). URL, eklenti manifestinde belirtilen URL'lerle aynı kaynağa ait olmalıdır.

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

• startActivityOnOpen: Zorunlu. Kullanıcı, sunum 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: Bir etkinlik başlatmadan yan panele yükleme

Aşağıdaki kod örneğinde, bir kullanıcı, etkinliğin başlatılabilmesi için kaynak izinlerinin ayarlanması gereken bir eklentiyle ekran paylaşıyor. Bu şart nedeniyle, eklenti herkes için etkinlik başlatılmadan yan panelde başlatılmalı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ında sayfayı paylaşan kullanıcı, Meet'te bir sunum banner'ı görür. Banner'daki düğmeyi tıkladığınızda, yan panelde belirtilen Cloud projesi numarası için eklenti açılır. startActivityOnOpen özelliği false olarak ayarlandığından ActivityStartingState ayarlanana kadar etkinliği 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şlatıldıktan sonra, görüşmedeki diğer kullanıcılardan eklentiyi başlatmaları veya yüklemeleri istenir.

GitHub'daki "Animation" örnek eklentisi bu örneği tam bir eklentinin parçası olarak içerir. Eklentiyle ilişkili web uygulamasının dizin sayfası gösterildiğinde, eklentiyi sunan kullanıcıdan eklentiyi yüklemesi veya ayarlaması 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şımı yapan 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ında sayfayı paylaşan kullanıcı, Meet'te bir sunum banner'ı görür. Banner'daki düğmeyi tıkladığınızda, ana ekranda belirtilen bulut projesi numarası için eklenti açılır. mainStageUrl özelliği yüklenir ve eklentinin etkinliğe başlama durumunu ayarlamak için additionalData özelliği kullanılır. Görüşmedeki diğer kullanıcılardan eklentiyi yüklemeleri veya başlatmaları istenir.

Örnek: Yan panele yükleme

Aşağıdaki kod örneğinde, bir kullanıcı, ana aşama yerine yan panelde başlamak isteyen bir eklentiyle ekran paylaşıyor:

<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ında sayfayı paylaşan kullanıcı, Meet'te bir sunum banner'ı görür. Banner'daki düğmeyi tıkladığınızda, yan panelde belirtilen Cloud projesi numarası için eklenti açılır. sidePanelUrl özelliği yüklenir ve eklentinin etkinliğe başlama durumunu ayarlamak için additionalData özelliği kullanılır. Görüşmedeki diğer kullanıcılardan eklentiyi yüklemeleri veya başlatmaları istenir.

Kaynak eşleştirme

mainStageUrl mülkünde ve sidePanelUrl mülkünde sağlanan kaynaklar, sağlanan bulut projesi 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 için Eklenti güvenliği başlıklı makaleyi inceleyin.

İlgili konular

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