นำ Co-Doing API ไปใช้

โปรแกรมทดลองใช้ก่อนเปิดตัว: ฟีเจอร์นี้ใช้ได้เฉพาะในตัวอย่างแบบจำกัดผ่านโปรแกรมทดลองใช้ก่อนเปิดตัวเท่านั้น

API การแชร์สดของ Google Meet จะใช้เพื่อซิงค์ข้อมูลที่กําหนดเองระหว่างผู้เข้าร่วมการประชุม ซึ่งอาจเป็นข้อมูลใดก็ได้ที่แอปของคุณใช้อ้างอิง

คุณต้องเรียงลำดับข้อมูลลงเป็น Uint8Array เพื่อส่งข้อมูล ดูข้อมูลเพิ่มเติมได้ที่การอ้างอิงไลบรารีมาตรฐานของ JavaScript

หากไม่แน่ใจเกี่ยวกับวิธีทำให้ข้อมูลเป็นอนุกรม ให้ตรวจสอบตัวอย่างโค้ดด้านล่าง

คู่มือนี้อธิบายวิธีใช้ Co-Doing API

สร้าง CoDoingClient

หากต้องการเริ่มต้นใช้งาน ให้สร้าง CoDoingClient จาก AddonSession ที่คุณสร้างไว้ในเริ่มต้นใช้งาน

หากต้องการสร้าง CoDoingClient ให้เรียกใช้เมธอด AddonSession.createCoDoingClient และระบุ CoDoingDelegate

CoDoingDelegate เป็นวิธีที่ Co-Doing API จะอัปเดตแอปพลิเคชันของคุณเมื่อมีสถานะใหม่พร้อมใช้งาน เมื่อมีการเรียกใช้เมธอด CoDoingDelegate.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 newState to your ongoing CoDoing activity
    },
  });

แทนที่ ACTIVITY_TITLE ด้วยชื่อกิจกรรมของคุณ

จัดการสถานะปัจจุบันของ

เมื่อผู้ใช้ดําเนินการในแอปพลิเคชัน คาดว่าแอปพลิเคชันจะเรียกใช้ CoDoingClient.broadcastStateUpdate ทันที

ตัวอย่างโค้ดต่อไปนี้แสดงการใช้งาน CoDoingClient.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 ด้วยสถานะปัจจุบันของแอป