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

在「觀看下一個」頻道插入內容時,請遵循以下準則。

「觀看下一個」頻道中要包含的內容類型

限制您的應用程式可透過程式添加傳統電影和電視節目。 請勿新增影片片段和其他短影片內容。

包括未完成的電影

使用 TYPE_MOVIE 將未看完的影片加入「接下來觀看」頻道。根據以下準則,如果一部電影已經開始拍攝但尚未完成,則該電影屬於未完成作品:

  • 如果用戶觀看超過 3% 或 2 分鐘(以較早的時間戳為準),則電影開始播放。
  • 電影結束的標誌是片尾字幕出現。在這種情況下,不要將其新增至「下一個觀看」頻道。您可以使用自動偵測片尾字幕的技術來確定此狀態,或使用基於內容長度的近似值。

包括未完成的電視劇集

使用 TYPE_TV_EPISODE 將未看完的電視劇集加入「接下來觀看」頻道。如果一集電視劇已經開始製作但尚未完成,則根據以下準則,該集電視劇將被視為未完成:

  • 如果用戶觀看時間超過 2 分鐘,則會開始播放一集。
  • 如果片尾字幕開始播放,則表示該集節目結束。在這種情況下,不要將其新增至「下一個觀看」頻道。您可以使用自動偵測片尾字幕的技術來確定此狀態,或使用基於內容長度的近似值,例如一集剩餘時間不到 3 分鐘。

處理新劇集和下一集的製作

根據以下準則,使用 TYPE_TV_EPISODE 將使用者已開始觀看的劇集的新劇集和下一集新增至「觀看下一集」頻道:

  • 如果用戶觀看該劇集中的任何一集超過 2 分鐘,或在片頭結束後 1 分鐘,則該用戶開始觀看該劇集。
  • 如果使用者開始觀看某個劇集並看完一集,並且該劇集的下一集在您的服務中可用,則使用 WATCH_NEXT_TYPE_NEXT 將下一集新增至「觀看下一集」頻道。
  • 如果使用者已完全追完某個系列的所有當前劇集,並且有新的一季或一集可用,則使用 WATCH_NEXT_TYPE_NEW 將此新劇集添加到「觀看下一集」頻道。無論用戶上次觀看該劇集是什麼時候,例如一年或更久,都要添加新劇集。

何時將項目新增至「接下來觀看」頻道

根據以下準則,將未看完的內容和之前觀看過的劇集的新劇集添加到「接下來觀看」頻道。

何時添加未完成的內容

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

  • 用戶在安卓電視上登出應用。
  • 用戶暫停或停止播放某段內容超過 5 分鐘。

在這些情況下,請立即發布任何未完成的內容,延遲時間最長為 5 秒。例如,當使用者退出 Android TV 應用程式時,在 5 秒內使用 Watch Next API 發布任何未完成的專案。

無論觀看地點在哪裡,都可以使用 Watch Next API 將任何未完成的內容發布到 Android TV。例如,如果用戶在 Chrome 瀏覽器中觀看電影並暫停,則 Android TV 上的應用程式必須立即將未完成的內容發布到 Android TV,最大延遲為 5 秒。

何時新增劇集

當滿足以下所有條件時,立即添加之前觀看過的劇集的新劇集:

  • 最新一集已在您的服務平台上線。
  • 用戶已完成上一集。
  • 用戶有權觀看最新一集。

無論用戶上次觀看該劇集是什麼時候,例如一年或更久,都要添加新劇集。

內容和使用者介面更新的資格

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

不要加入同一部電視劇的多集內容。例如,不要同時添加同一集中未完結的一集和新一集。

播放下一個 行中的一個項目變更時,不要更新該行中的所有項目。僅有的更新用戶自上次更新以來互動過的項目。

「下一個觀看」項目應包含哪些數據

每個「下一個觀看」項目都應包含以下內容:

  • 觀看下一個類型
  • 上次播放位置
  • 時間長度
  • 上次互動時間
  • 視訊節目屬性:除了視訊節目屬性表中標記的必要屬性外,每個視訊節目都必須設定內容 ID 屬性。Content ID 屬性必須與您在 Media Actions feed 中提供的內部 ID 相符。這使得 Android TV 能夠更有效地協調資產,並為使用者提供高度可靠的功能。

從「觀看下一個」頻道移除內容

用戶看完電影或電視劇沒有未觀看的劇集後,刪除相關內容。