นำ Co-Watching API ไปใช้

โปรแกรมทดลองใช้ก่อนเปิดตัว: ฟีเจอร์นี้ให้บริการเฉพาะใน การดูที่จำกัดผ่านโปรแกรมทดลองใช้ก่อนเปิดตัว ขณะนี้โปรแกรมนี้เปิดให้ลงชื่อสมัครใช้ใหม่แล้ว

API การแชร์สดของ Google Meet จะจัดการประสบการณ์การประชุมของผู้เข้าร่วมหลายคน ดูหรือฟังเนื้อหาในแอป

คู่มือนี้อธิบายวิธีใช้ API การดูร่วมกัน

สร้าง CoWatchingClient

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

หากต้องการสร้าง CoWatchingCient ให้เรียกใช้ AddonSession.createCoWatchingClient และระบุ CoWatchingDelegate

CoWatchingDelegate คือวิธีที่ API การดูร่วมกันอัปเดต เมื่อใดก็ตามที่มีสถานะใหม่ คาดว่าเมื่อ CoWatchingDelegate.onCoWatchingStateChanged จะถูกเรียก แอปพลิเคชันของคุณจะใช้สถานะใหม่ทันที

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีใช้ API การดูร่วมกัน

TypeScript

 const coWatchingClient = await addonSession.createCoWatchingClient({
    activityTitle: "ACTIVITY_TITLE",
    onCoWatchingStateQuery() {
      // This function should return the current state of your CoWatching activity
      return getMyApplicationCoWatchingState();
    },
    onCoWatchingStateChanged(coWatchingState: CoWatchingState) {
      // This function should apply newState to your ongoing CoWatching activity
    },
  });

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

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

เมื่อผู้ใช้ดำเนินการในแอปพลิเคชันของคุณ จะคาดหวังว่าแอปพลิเคชันของคุณ เรียกใช้เมธอด API ที่ระบุไว้ทันที

คุณควรเรียกใช้วิธีการเหล่านี้เพื่อตอบสนองต่อเหตุการณ์สำคัญเท่านั้น สำหรับ เช่น คุณไม่จำเป็นต้องโทรหาทุกครั้งที่แอปเล่นเกม ในการสร้างสรรค์วิดีโอ CoWatchingDelegate ที่คุณสร้างไว้ข้างต้นกำลังได้รับการอัปเดต ตำแหน่งที่เล่นได้ในสถานการณ์เหล่านี้

คุณควบคุมสถานะการดูร่วมกันได้โดยใช้วิธีการเหล่านี้

• CoWatchingClient.notifySwitchToMedia โทรเมื่อสื่อที่เล่นอยู่มีการเปลี่ยนแปลง ตัวอย่างเช่น ผู้ใช้ เลือกวิดีโอใหม่ หรือเล่นอัตโนมัติจะเริ่มวิดีโอถัดไป
• CoWatchingClient.notifyPauseState โทรเมื่อผู้ใช้หยุดชั่วคราวหรือยกเลิกการหยุดสื่อที่เล่นไว้ชั่วคราว
• CoWatchingClient.notifySeekToTimestamp เรียกใช้เมื่อผู้ใช้เปลี่ยนตำแหน่งการเล่นอย่างชัดเจน
• CoWatchingClient.notifyPlayoutRate เรียกใช้เมื่อผู้ใช้อัปเดตความเร็วในการเล่นเป็นค่าใหม่ (เช่น 1.25x)
• CoWatchingClient.notifyBuffering เรียกใช้เมื่อแอปของผู้ใช้เริ่มบัฟเฟอร์เนื่องจากมีการบัฟเฟอร์จากสื่อก่อนหน้า การค้นหาสื่อ ความคับคั่งของเครือข่าย
• CoWatchingClient.notifyReady โทรเมื่อบัฟเฟอร์เสร็จสมบูรณ์ และสื่อก็พร้อมที่จะเล่น