應用程式開發人員適用的「接下來請看」指南

將內容插入「接下來請看」頻道時,請遵守下列規範

要加入「接下來請看」頻道的內容類型

限制應用程式對傳統電影和電視節目的程式輔助新增內容。請勿新增剪輯片段和其他短片。

包含未看完的電影

使用 TYPE_MOVIE 將未看完的電影新增至「接下來請看」頻道。如果電影已開始播放但尚未看完,則視下列規範為未完成:

  • 如果使用者觀看超過 3% 或 2 分鐘,電影就會開始播放 (以時間戳記較早者為準)。
  • 如果片尾製作人員名單出現,電影已看完。在這種情況下,請不要將其新增到「接下來請看」頻道。您可以使用自動偵測最終製作人員抵免額的技術,或使用以內容長度為依據的近似值,來判斷狀態。

包括未看完的電視劇集

使用 TYPE_TV_EPISODE 將未看完的電視劇集新增至「接下來請看」頻道。如果劇集已開始,但根據下列規範未結束,則代表劇集未完成:

  • 如果使用者觀看超過 2 分鐘,系統就會開始播放劇集。
  • 如果結尾製作人員名單出現,即表示劇集已結束。在這種情況下,請不要將其新增到「接下來請看」頻道。如要判斷此狀態,您可以使用自動偵測最終製作人員名單的技術,或使用以內容長度為依據的近似值,例如單集節目剩餘時間不到 3 分鐘。

處理新的電視劇集和下一集電視劇集

根據下列指南,使用 TYPE_TV_EPISODE 將使用者已展開的新劇集和下一集節目新增至「接下來請看」頻道:

  • 如果使用者觀看超過 2 分鐘,或看完系列的任一集內容超過 1 分鐘,系統就會開始觀看系列影片。
  • 如果使用者開始播放影集並完成劇集,且服務中提供該系列的下一集,請使用 WATCH_NEXT_TYPE_NEXT 將下一集新增至「接下來請看」頻道。
  • 如果使用者已完全收看影集中的所有目前劇集,並且有新的季別或劇集可供觀看,請使用 WATCH_NEXT_TYPE_NEW 將新劇集新增至「接下來請看」頻道。無論使用者上次觀看系列影片多久後 (例如一年後),請新增新劇集。

何時該將商品新增至「接下來請看」頻道

根據下列規範,將未看完的內容和先前看過的系列節目新集數新增至「接下來請看」頻道。

新增未看完內容的時機

當使用者有未看完的內容時,請在發生下列任一情況時,立即將該內容新增至「接下來請看」頻道:

  • 使用者在 Android TV 上退出應用程式。
  • 使用者暫停或停止播放內容超過 5 分鐘。

在這些情境下,立即發布所有未完成的內容 (延遲時間最長為 5 秒)。舉例來說,當使用者退出 Android TV 應用程式時,請在 5 秒內使用「接下來請看」 API 發布所有未完成的項目。

無論影片播放位置為何,都可以透過 Watch Next API 將任何未看完的內容發布至 Android TV。舉例來說,如果使用者在 Chrome 瀏覽器中觀看電影並暫停,Android TV 上的應用程式必須立即將未完成的內容發布至 Android TV,且延遲時間最長為 5 秒。

新增集數的時機

只要符合下列所有條件,就能立即為先前看過的系列新增劇集:

  • 新集數在你的服務中已上架。
  • 使用者看完上一集。
  • 使用者有權觀看新劇集。

無論使用者上次觀看系列影片多久後 (例如一年後),請新增新劇集。

內容和 UI 更新資格

使用者必須與應用程式中的內容互動,才能將內容發布至「接下來請看」頻道。

請勿加入同一電視影集中的多集內容。例如,請勿加入同一系列中未看完的劇集和新劇集。

不要在一個項目變更時更新「接著播放」列中的所有項目。更新自上次更新後,使用者進行互動的項目。

要納入「接下來請看」項目的資料

為每個「接下來請看」項目加入以下內容:

  • 「接下來請看」類型
  • 上次播放位置
  • 時間長度
  • 上次互動時間
  • 影片節目屬性:除了在影片節目屬性表中標示的必要屬性之外,您還必須為每個影片節目設定 Content ID 屬性。Content ID 屬性必須與您在媒體動作動態饋給中提供的內部 ID 相符。這可讓 Android TV 更有效率地協調資產,並為使用者提供高度信心的功能。

移除「接下來請看」頻道中的內容

在使用者看完電影或電視影集沒有未觀看的劇集時移除內容。