Co-Doing API는 회의 참석자 간에 임의의 데이터를 동기화하는 데 사용됩니다. 앱에서 사용하는 모든 데이터가 될 수 있습니다.
데이터를 전송하려면 데이터를 Uint8Array
로 직렬화해야 합니다. 자세한 내용은 JavaScript 표준 라이브러리 참조를 확인하세요.
데이터를 직렬화하는 방법을 잘 모르겠다면 다음 코드 샘플을 검토하세요.
이 가이드에서는 Co-Doing API를 구현하는 방법을 설명합니다.
시작하기
Co-Doing API를 사용하려면 먼저 Meet 부가기능을 배포해야 합니다. 이 단계를 완료하면 새 부가기능에서 Co-Doing API를 사용할 수 있습니다.
Co-Doing API를 사용하려면 먼저 Google Meet 공동 활동의 진입점 역할을 하는 AddonSession
객체를 가져옵니다.
TypeScript
const session = await window.meet.addon.createAddonSession({
cloudProjectNumber: "CLOUD_PROJECT_NUMBER",
});
CLOUD_PROJECT_NUMBER를 Google Cloud 프로젝트의 프로젝트 번호로 바꿉니다.
공동작업 클라이언트 만들기
시작하려면 AddonSession
에서 CoDoingClient
객체를 만듭니다.
CoDoingClient
를 만들려면 createCoDoingClient()
메서드를 호출하고 CoDoingDelegate
객체를 제공합니다.
CoDoingDelegate
는 Co-Doing API가 사용 가능한 새 상태가 있을 때마다 앱을 업데이트하는 방법입니다. onCoDoingStateChanged()
메서드가 호출되면 앱이 새 상태를 즉시 적용해야 합니다.
다음 코드 샘플은 Co-Doing API를 사용하는 방법을 보여줍니다.
TypeScript
interface MyState {
someString: string;
someNumber: number;
}
/**
* Serialize/deserialize using JSON.stringify
* You can use any method you want; this is included for as an example
*/
function toBytes(state: MyState): Uint8Array {
return new TextEncoder().encode(JSON.stringify(state));
}
function fromBytes(bytes: Uint8Array): MyState {
return JSON.parse(new TextDecoder().decode(bytes)) as MyState;
}
const coDoingClient = await addonSession.createCoDoingClient({
activityTitle: "ACTIVITY_TITLE",
onCoDoingStateChanged(coDoingState: CoDoingState) {
const newState = fromBytes(coDoingState.bytes);
// This function should apply the new state to your ongoing CoDoing activity
},
});
ACTIVITY_TITLE을 활동 제목으로 바꿉니다.
현재 상태 관리
사용자가 앱에서 작업을 실행하면 앱은 즉시 broadcastStateUpdate()
메서드를 호출해야 합니다.
다음 코드 샘플은 broadcastStateUpdate()
메서드의 구현을 보여줍니다.
TypeScript
const myState: MyState = {
someString: "SOME_STRING",
someNumber: 0
};
document.getElementById('some-button').onClick(() => {
myState.someNumber = myState.someNumber + 1;
coDoingClient.broadcastStateUpdate({ bytes: toBytes(myState) });
});
SOME_STRING를 앱의 현재 상태로 바꿉니다.