Bu sayfada, başka bir web sayfasına az miktarda kod yerleştirerek Google Meet ile bir sekmeyi ekran paylaşırken kullanıcılara eklentiyi nasıl tanıtacağınız 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ızcastartActivityOnOpenözelliği doğruysa veActivityStartingStatekullanı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ıktan sonra 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 (önerilen)
Projenizde npm kullanılıyorsa Meet eklentileri SDK'sı npm paketi ile ilgili talimatları uygulayabilirsiniz.
Öncelikle npm paketini yükleyin:
npm install @googleworkspace/meet-addons
Ardından, Meet eklentileri SDK'sını MeetAddonScreenshareExport arayüzünü içe aktararak kullanabilirsiniz:
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 uygulamanıza aşağıdaki komut dosyası etiketini ekleyin:
<script src="https://www.gstatic.com/meetjs/addons/1.1.0/meet.addons.screenshare.js"></script>
Meet eklentileri SDK'sı, window.meet.addon altındaki MeetAddon arayüzünden kullanılabilir.
Ö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.