부가기능을 연 후 부가기능이 startActivity() 메서드를 호출하면 측면 패널 사용자가 공동작업을 시작할 수 있습니다.
예를 들어 부가기능은 사용자가 문서에서 공동작업하도록 허용하고 싶지만 어떤 문서인지 알지 못합니다. 이 경우 문서가 측면 패널 뷰에서 선택되어야 합니다. 문서를 다른 사용자와 공유할 수 있는지 확인한 후 부가기능은 다른 필수 문서 식별자와 함께 ActivityStartingState를 설정할 수 있습니다.
기본 화면에서 공동작업하기
공동 작업 활동은 측면 패널 또는 기본 스테이지에서 할 수 있습니다. mainStageUrl이 부가기능 매니페스트에 나열된 경우 startActivity() 메서드를 호출하면 기본 스테이지에서 부가기능이 자동으로 열리고 활동이 시작됩니다.
메인 화면이 열리면 부가기능이 unloadSidePanel() 메서드를 호출하여 측면 패널을 닫을 수 있습니다. 이전 예시를 확장하면 문서를 선택하는 측면 패널이 더 이상 관련이 없을 수 있으므로 닫을 수 있습니다.
측면 패널 뷰를 다시 열려면 부가기능에서 loadSidePanel() 메서드를 호출하면 됩니다. 예를 들어 사용자 설문조사를 만드는 부가기능은 질문 응답률을 표시하기 위해 측면 패널을 다시 열 수 있습니다.
화면 공유에서 부가기능 시작하기
사용자는 화면 공유 중에 부가기능을 시작할 수 있습니다. 사용자가 애드온이 있는 웹사이트를 화면 공유하는 경우 해당 웹사이트는 exposeToMeetWhenScreensharing() 메서드를 사용하여 사용자에게 애드온을 홍보할 수 있습니다. 이렇게 하면 Meet 통화에 사용자에게 애드온을 설치하거나 시작하라는 메시지가 표시된 알림 배너가 표시됩니다. 자세한 내용은 화면 공유를 통해 사용자에게 부가기능 홍보하기를 참고하세요.
사용자가 화면을 공유하는 웹사이트에서 부가기능 시작 상태에 추가 정보를 제공할 수 있으므로 부가기능은 측면 패널을 건너뛰고 실행 직후 기본 스테이지에서 활동을 시작할 수 있습니다. 문서의 권한을 변경하여 공유하는 등 부가기능에서 추가 단계를 실행해야 하는 경우 부가기능이 측면 패널에서 실행되어 다른 사용자와 공동작업하기에 설명된 흐름을 따를 수 있습니다.
[null,null,["최종 업데이트: 2025-08-29(UTC)"],[],[],null,["# Use a Meet add-on\n\nThis guide provides an overview of how people start and work with a\nGoogle Meet add-on.\n\nStart an add-on from the Activities panel\n-----------------------------------------\n\nFrom a Google Meet call, a user can click the Activities button. This brings\nup the Activities panel, which shows a list of built-in Meet\nfeatures and any add-ons the user has installed. Clicking on an\nicon launches the side panel view of the add-on.\n**Figure 1.** The Google Meet add-ons SDK main stage and side panel.\n\nCollaborate with other users\n----------------------------\n\nTo allow users to collaborate together, the add-on can\nset the\n[`ActivityStartingState`](/workspace/meet/add-ons/reference/websdk/addon_sdk.activitystartingstate).\nFor more information, see [Collaborate using a\nMeet add-on](/workspace/meet/add-ons/guides/collaborate-in-the-add-on).\n\nAfter opening an add-on, side panel users can start\nworking together once the add-on invokes the\n[`startActivity()`](/workspace/meet/add-ons/reference/websdk/addon_sdk.meetaddonclient.startactivity)\nmethod.\n\nFor example, an add-on might want to allow users to\ncollaborate on a document, but the add-on doesn't know\nwhich document. In this case, the document should be selected from the side\npanel view. After ensuring the document can be shared with others, the\nadd-on can set `ActivityStartingState` with other\nnecessary document identifiers.\n\nCollaborate in the main stage\n-----------------------------\n\nCollaborative activities can be done in the side panel or the main stage. If a\n`mainStageUrl` is listed in the add-on manifest,\ninvoking the\n[`startActivity()`](/workspace/meet/add-ons/reference/websdk/addon_sdk.meetaddonclient.startactivity)\nmethod automatically opens the add-on in the main stage\nand starts the activity.\n\nOnce the main stage is open, an add-on might choose to\nclose the side panel by calling the\n[`unloadSidePanel()`](/workspace/meet/add-ons/reference/websdk/addon_sdk.meetmainstageclient.unloadsidepanel)\nmethod. To extend the earlier example, a side panel that chooses a document may\nno longer be relevant and can be closed.\n\nTo re-open the side panel view, the add-on can call the\n[`loadSidePanel()`](/workspace/meet/add-ons/reference/websdk/addon_sdk.meetmainstageclient.loadsidepanel)\nmethod. For example, an add-on that creates user polls\nmight reopen the side panel to display question response rates.\n\nStart an add-on from screen sharing\n-----------------------------------\n\nUsers can start add-ons while screen sharing. If a user is screen\nsharing a website that has an add-on, that website can\npromote its add-on to the user by using the\n[`exposeToMeetWhenScreensharing()`](/workspace/meet/add-ons/reference/websdk/screenshare_api.meetaddonscreenshare.exposetomeetwhenscreensharing)\nmethod. This shows the user a notification banner in the Meet\ncall, prompting the user to either install or start the\nadd-on. For more information, see [Promote an\nadd-on to users through screen\nsharing](/workspace/meet/add-ons/guides/promote#screen_sharing).\n\nSince additional information can be supplied to the\nadd-on starting state from the website the user is\nscreen sharing, the add-on can skip the side panel and\nstart the activity in the main stage immediately after launching. If the\nadd-on needs to perform additional steps, like changing\npermissions on a document to share, the add-on can\nlaunch into the side panel and follow the flow described in [Collaborate with\nother users](#collaborate-with-other-users).\n\nRelated topics\n--------------\n\n- [Collaborate using a Meet add-on](/workspace/meet/add-ons/guides/collaborate-in-the-add-on)\n- [Promote an add-on to users through screen sharing](/workspace/meet/add-ons/guides/screen-sharing)"]]