साथ मिलकर देखने का एपीआई लागू करना

Google Meet Live हवा शेयरिंग एपीआई, कई लोगों के ऐप्लिकेशन के कॉन्टेंट को देखने या सुनने के अनुभव को मैनेज करता है.

इस गाइड में, Co- जुड़ने के एपीआई को लागू करने का तरीका बताया गया है.

CoWatchingClient बनाएं

शुरू करने के लिए, शुरू करें में बनाए गए AddonSession से createCoWatchingClient बनाएं.

CoWatchingCient बनाने के लिए, AddonSession.createCoWatchingClient तरीके का इस्तेमाल करें और CoWatchingDelegate की जानकारी दें.

नई स्थिति में ऐप्लिकेशन को CoWatchingDelegate की मदद से देखा जा सकता है. इसलिए, यह एपीआई आपके ऐप्लिकेशन को अपडेट करता है. यह उम्मीद की जाती है कि CoWatchingDelegate.onCoWatchingStateChanged तरीके को कॉल करने पर, आपका ऐप्लिकेशन तुरंत नई स्थिति को लागू कर देगा.

नीचे दिए गए कोड सैंपल में, Co-देखें एपीआई को इस्तेमाल करने का तरीका बताया गया है:

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 को अपनी गतिविधि के मीडिया टाइटल से बदलें.

मौजूदा स्थिति मैनेज करें

जब उपयोगकर्ता आपके ऐप्लिकेशन में कोई कार्रवाई करते हैं, तो उम्मीद है कि आपका ऐप्लिकेशन दिए गए एपीआई के तरीकों का तुरंत कॉल करेगा.

आपको इन तरीकों का इस्तेमाल सिर्फ़ अहम इवेंट के लिए करना चाहिए. उदाहरण के लिए, जब आपका ऐप्लिकेशन चल रहे वीडियो को बेहतर बनाता है, तब आपको हर बार उन्हें कॉल करने की ज़रूरत नहीं है. आपने ऊपर जो CoWatchingDelegate बनाया है वह इन परिस्थितियों में, प्लेआउट पोज़िशन को अपडेट करने का काम करता है.

साथ मिलकर वीडियो देखने की स्थिति को कंट्रोल करने के लिए, इन तरीकों का इस्तेमाल करें:

  • CoWatchingClient.notifySwitchToMedia: जब भी मीडिया चल रहा हो, तो उसमें बदलाव करें. उदाहरण के लिए, जब उपयोगकर्ता नया वीडियो चुनता है या अपने-आप अगला वीडियो शुरू करता है.
  • CoWatchingClient.notifyPauseState: जब कोई उपयोगकर्ता मीडिया को रोकता या फिर से चालू करता है, तब इसे कॉल किया जाता है.
  • CoWatchingClient.notifySeekToTimestamp: जब कोई उपयोगकर्ता साफ़ तौर पर प्ले आउट की स्थिति बदलता है, तब उसे कॉल करें.
  • CoWatchingClient.notifyPlayoutRate: जब कोई उपयोगकर्ता, वीडियो चलाने की स्पीड को नई वैल्यू पर अपडेट करता है, तो कॉल करें. उदाहरण के लिए, 1.25x.
  • CoWatchingClient.notifyBuffering: जब उपयोगकर्ता का ऐप्लिकेशन, पिछले मीडिया स्विच, मीडिया सीक या नेटवर्क कंजेशन की वजह से बफ़रिंग की वजह से बफ़र होना शुरू हो जाए, तब कॉल करें.
  • CoWatchingClient.notifyReady: यह तब कॉल करें, जब बफ़रिंग पूरी हो जाए और मीडिया अब चलने के लिए तैयार हो.