應用程式開發人員適用的「接下來請看」指南
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
將內容插入「接下來請看」頻道時,請遵守下列規範
要加入「接下來請看」頻道的內容類型
限制應用程式對傳統電影和電視節目的程式輔助新增內容。請勿新增剪輯片段和其他短片。
包含未看完的電影
使用 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 更有效率地協調資產,並為使用者提供高度信心的功能。
移除「接下來請看」頻道中的內容
在使用者看完電影或電視影集沒有未觀看的劇集時移除內容。
這個頁面中的內容和程式碼範例均受《內容授權》中的授權所規範。Java 與 OpenJDK 是 Oracle 和/或其關係企業的商標或註冊商標。
上次更新時間:2025-07-27 (世界標準時間)。
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2025-07-27 (世界標準時間)。"],[],[],null,["# Watch Next guidelines for app developers\n\nFollow these guidelines when you insert content into the\nWatch Next channel.\n\nTypes of content to include in the Watch Next channel\n-----------------------------------------------------\n\nLimit your app's programmatic additions to traditional movies and TV\nshows. Don't add clips and other short-form content.\n\n### Include unfinished movies\n\nAdd unfinished movies to the Watch Next channel using\n[`TYPE_MOVIE`](/training/tv/discovery/video-programs). A movie is unfinished\nif it is started but not finished based on the following guidelines:\n\n- A movie is started if the user watches more than 3% or 2 minutes, whichever timestamp is earlier.\n- A movie is finished if the end credits start. In this case, do *not* add it to the Watch Next channel. You can determine this state using a technology that auto-detects the end credits or use an approximation based on the content length.\n\n### Include unfinished TV episodes\n\nAdd unfinished TV episodes to the Watch Next channel using\n[`TYPE_TV_EPISODE`](/training/tv/discovery/video-programs). An episode is\nunfinished if it is started but not finished based on the following guidelines:\n\n- An episode is started if the user watches more than 2 minutes.\n- An episode is finished if the end credits start. In this case, do *not* add it to the Watch Next channel. You can determine this state using a technology that auto-detects the end credits or use an approximation based on the content length, such as less than 3 minutes remaining in an episode.\n\nHandle new TV episodes and next TV episodes\n-------------------------------------------\n\nAdd new episodes and next episodes of series that the user has started,\nbased on the following guidelines, to the Watch Next channel using\n[`TYPE_TV_EPISODE`](/training/tv/discovery/video-programs):\n\n- The user starts a series if they watch more than 2 minutes, or 1 minute after the introduction completes, of any episode in the series.\n- If the user starts a series and finishes an episode, and the next episode in the series is available in your service, add this next episode to the Watch Next channel using [`WATCH_NEXT_TYPE_NEXT`](/training/tv/discovery/watch-next-programs).\n- If the user is fully caught up on all current episodes in a series and a new season or episode becomes available, add this new episode to the Watch Next channel using [`WATCH_NEXT_TYPE_NEW`](/training/tv/discovery/watch-next-programs). Add the new episode no matter how long it has been since the user last watched the series, such as after a year or more.\n\nWhen to add an item to the Watch Next channel\n---------------------------------------------\n\nAdd unfinished content and new episodes of previously viewed series\nto the Watch Next channel according to the following guidelines.\n\n### When to add unfinished content\n\nWhen a user has an unfinished piece of content, add that content to the Watch\nNext channel immediately when either of the following occur:\n\n- The user exits the app on Android TV.\n- The user pauses or stops playback for a piece of content for more than 5 minutes.\n\nIn these scenarios, publish any unfinished content immediately, with a\nmaximum latency of 5 seconds. For example, when the user exits the\nAndroid TV app, publish any unfinished items using the Watch Next\nAPI within 5 seconds.\n\nPublish any unfinished content to Android TV using the Watch Next API\nregardless of where the viewing occurred. For example, if the user watches a\nmovie in their Chrome browser and pauses it, then the app on the Android TV\nmust publish the unfinished content to the Android TV immediately, with a\nmaximum latency of 5 seconds.\n\n### When to add new episodes\n\nAdd new episodes of a previously watched series\nimmediately when all of the following are true:\n\n- The new episode is available on your service.\n- The user completes the previous episode.\n- The user is entitled to watch the new episode.\n\nAdd the new episode no matter how long it has been since the user last watched\nthe series, such as after a year or more.\n\n### Eligibility of content and UI updates\n\nThe user must interact with the content within your app for the content\nto be eligible to be published to the Watch Next channel.\n\nDon't add more than one episode from the same TV series. For example, don't add\nan unfinished episode and a new episode from the same series.\n\nDon't update all items in the **Play Next** row when one item changes.\n*Only* update the item the user has interacted with since the last update.\n\nWhat data to include for a Watch Next item\n------------------------------------------\n\nInclude the following for each Watch Next item:\n\n- Watch Next type\n- Last playback position\n- Duration\n- Last engagement time\n- Video program attributes: in addition to the required attributes marked in the [video program attributes table](/training/tv/discovery/video-programs#attribute-table), the [Content ID attribute](/reference/androidx/tvprovider/media/tv/PreviewProgram.Builder#setContentId(java.lang.String)) must be set for every video program. The Content ID attribute must match the internal ID you provide in the [Media Actions](https://developers.google.com/actions/media) feed. This lets Android TV reconcile the asset more effectively and provides a high-confidence feature to users.\n\nRemove content from the Watch Next channel\n------------------------------------------\n\nRemove content once the user finishes watching a movie or there\nis no unwatched available episode for a TV series."]]