이 페이지에서는 Google Meet과 화면을 공유하는 동안 다른 웹페이지에 약간의 코드를 배치하여 사용자에게 부가기능을 홍보하는 방법을 설명합니다.
MeetAddonScreenshare.exposeToMeetWhenScreensharing
메서드를 사용하면 탭이 화면 공유될 때 사이트에서 Meet으로 정보를 전송할 수 있습니다. 이 정보는 부가기능이 설치된 경우 사용자가 프레젠테이션 배너에서 '활동 시작'을 클릭할 때 Meet의 부가기능 환경에서 사용됩니다. 사용자가 탭을 화면 공유 시 부가기능을 설치하지 않은 경우 부가기능을 설치하라는 메시지가 표시됩니다.
AddonScreenshareInfo
객체에는 사용 사례에 따라 추가할 수 있는 5개의 필드가 포함됩니다.
AddonScreenshareInfo.additionalData
: 부가기능이 자체적으로 초기화하는 데 사용할 수 있는 정보입니다.AddonScreenshareInfo.startActivityOnOpen
가 true인 경우에만 설정할 수 있고CollaborationStartingState
를 사용하여 액세스할 수 있습니다. 자세한 내용은 공동작업 시작 상태 사용을 참고하세요.AddonScreenshareInfo.cloudProjectNumber
: 필수. 부가기능의 Google Cloud 프로젝트 번호입니다.AddonScreenshareInfo.mainStageUrl
: 부가기능이 시작되면 기본 단계에서 열리는 URL입니다(예:https://www.example.com
). URL은 부가기능 매니페스트에 지정된 URL과 동일한 출처에 속해야 합니다.AddonScreenshareInfo.sidePanelUrl
: 부가기능이 시작되면 측면 패널이 열리는 URL입니다(예:https://www.example.com
). URL은 부가기능 매니페스트에 지정된 URL과 동일한 출처에 속해야 합니다.AddonScreenshareInfo.startActivityOnOpen
: 필수. 사용자가 프레젠테이션 배너에서 부가기능을 시작할 때 Meet의 공동작업 부가기능 환경을 즉시 시작할지 여부입니다.AddonScreenshareInfo.mainStageUrl
를 사용할 경우 true여야 합니다.
예: 기본 단계에서 로드
다음 코드 샘플에서는 Meet에서 다음 코드가 포함된 웹페이지를 화면을 공유하는 사용자에게 부가기능을 실행하라는 메시지가 표시됩니다.
<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>
다음을 바꿉니다.
- CLOUD_PROJECT_NUMBER: 문자열. 클라우드 프로젝트 번호입니다.
- MAIN_STAGE_URL: 문자열. 기본 단계의 URL입니다.
Meet 통화 화면의 사용자가 페이지를 공유하면 Meet에 프레젠테이션 배너가 표시됩니다. 배너에 있는 버튼을 클릭하면
지정된 클라우드 프로젝트 번호에 해당하는 부가기능이 기본 단계에서
열립니다. AddonScreenshareInfo.mainStageUrl
가 로드되고 AddonScreenshareInfo.additionalData
가 부가기능의 공동작업 시작 상태를 설정하는 데 사용됩니다. 통화 중인 다른 사용자에게는 부가기능을 설치하거나 실행하라는 메시지가 즉시 표시됩니다.
예: 측면 패널에 로드
다음 코드 샘플에서는 사용자 화면에서 기본 단계가 아닌 측면 패널에서 시작하려는 부가기능이 있는 페이지를 공유합니다.
<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>
다음을 바꿉니다.
- CLOUD_PROJECT_NUMBER: 문자열. 클라우드 프로젝트 번호입니다.
- SIDE_PANEL_URL: 문자열. 측면 패널의 URL입니다.
Meet 통화 화면의 사용자가 페이지를 공유하면 Meet에 프레젠테이션 배너가 표시됩니다. 배너에 있는 버튼을 클릭하면 측면 패널에 지정된 클라우드 프로젝트 번호에 해당하는 부가기능이 열립니다. AddonScreenshareInfo.sidePanelUrl
가 로드되고 AddonScreenshareInfo.additionalData
가 부가기능의 공동작업 시작 상태를 설정하는 데 사용됩니다. 통화 중인 다른 사용자에게는 부가기능을 설치하거나 실행하라는 메시지가 즉시 표시됩니다.
예: 공동작업을 시작하지 않고 측면 패널에 로드하기
다음 코드 샘플에서는 공동작업 활동을 시작하기 전에 리소스 권한을 조정해야 하는 부가기능이 있는 사용자 화면에서 페이지를 공유합니다. 이 요구사항으로 인해 부가기능은 측면 패널에서 시작되어야 하며, 모든 사용자가 공동작업이 시작되지는 않습니다.
<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>
다음을 바꿉니다.
- CLOUD_PROJECT_NUMBER: 문자열. 클라우드 프로젝트 번호입니다.
- SIDE_PANEL_URL: 문자열. 측면 패널의 URL입니다.
Meet 통화 화면의 사용자가 페이지를 공유하면 Meet에 프레젠테이션 배너가 표시됩니다. 배너에 있는 버튼을 클릭하면 측면 패널에 지정된 클라우드 프로젝트 번호에 해당하는 부가기능이 열립니다. AddonScreenshareInfo.startActivityOnOpen
가 false로 설정되었으므로 CollaborationStartingState
가 설정될 때까지 활동 시작 버튼이 사용 중지됩니다. 자세한 내용은 공동작업 시작 상태 사용을 참고하세요.
활동이 시작되면 통화 중인 다른 사용자에게 부가기능을 실행하거나 설치하라는 메시지가 표시됩니다.
출처 일치
AddonScreenshareInfo.mainStageUrl
및 AddonScreenshareInfo.sidePanelUrl
에 제공된 출처는 제공된 클라우드 프로젝트 번호의 부가기능 매니페스트에 있는 출처와 비교됩니다. 모든 항목이 일치하면 사용자는 부가기능을 실행할 수 있습니다.
또한 화면 공유를 시작하는 사이트의 출처가 부가기능 매니페스트의 addOnOrigins
필드에 나열되어야 합니다.
자세한 내용은 부가기능 보안을 참고하세요.