Co-Doing API 구현

Co-Doing API는 회의 참석자 간에 임의의 데이터를 동기화하는 데 사용됩니다. 앱이 의존하는 모든 데이터가 될 수 있습니다.

데이터가 전송되려면 Uint8Array로 직렬화해야 합니다. 자세한 내용은 JavaScript 표준 라이브러리 참조를 참고하세요.

데이터를 직렬화하는 방법을 잘 모르는 경우 다음 코드 샘플을 검토하세요.

이 가이드에서는 공동 작업 API를 구현하는 방법을 설명합니다.

시작하기

Co-Doing API를 사용하려면 먼저 Meet 부가기능을 배포해야 합니다. 이 단계를 완료하면 새 부가기능 내에서 공동 작업 API를 사용할 수 있습니다.

공동 작업 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는 공동 작업 API가 사용 가능한 새 상태가 있을 때마다 앱을 업데이트하는 방식입니다. onCoDoingStateChanged() 메서드가 호출되면 앱이 새 상태를 즉시 적용해야 합니다.

다음 코드 샘플은 공동 작업 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을 앱의 현재 상태로 바꿉니다.