直播

Cast SDK 內建支援直播內容的 API。這包括 靈活的現成使用者介面，再搭配可讓開發人員建立內容豐富的 API 只需幾行程式碼，就能輕鬆上手Live API 支援顯示 開始和結束時間、節目中繼資料、DVR 控制項和可搜尋的時間範圍。

本指南說明如何設定對 Live API 的串流，包括 設定核心直播情境的程式碼與中繼資料範例，以及 這張螢幕截圖呈現了每種情境的效果

必要條件

熟悉導入 須先使用網路接收端才能查看這項內容 指南。此外，若要執行程式碼範例，您必須可存取 必須符合 投放支援的媒體類型。一般而言，直播功能 支援 支援的媒體。

本指南將使用以下字詞：

  • 可跳轉的視窗：使用者可以跳轉的直播範圍。
  • Live Edge - 播放器可供播放器使用的最新直播部分。
  • 播放頭 - 目前播放位置的 UI 時間戳記。

投放直播

您可以透過兩種方式將 Web Receiver SDK 設為使用 Live API 內容：

  1. 請在 Web Receiver 應用程式中使用 LOAD 訊息攔截器。 (建議)
  2. 傳送及接收請求

攔截器會提供 LoadRequestData敬上 物件，內含載入要求的所有重要中繼資料。目的地： 表示適用於直播的載入要求，只需將 streamType敬上 的 mediaInformation。 對象 StreamType.LIVE。 MediaInformation.duration 應為 -1，因為玩家例項 ，並在內容為 LIVE 時進行計算。

/*
* This interceptor is called before your content is loaded by a Cast device
*/
playerManager.setMessageInterceptor(
   cast.framework.messages.MessageType.LOAD,
   request => { /* cast.framework.messages.LoadRequestData */
       request.media.streamType = cast.framework.messages.StreamType.LIVE;
   return request;
});

新增節目指南資料

直播 (特別是電視頻道等長時間放送的直播) 提供以下功能： 根據目前播放內容在畫面上顯示指南/節目規劃中繼資料 用於直播中的位置強烈建議提供內容供應器 為 Web Receiver 應用程式中的程式設計中繼資料提供更完善的使用者 無須專人管理

您可以在 LOAD 訊息中設定串流的初始指南資料 如同我們表示該直播是 先前的例子直播中的個別版面或節目 代表 MediaMetadata敬上 系統隨後會將物件儲存在 佇列。 MediaMetadata不同類型的程式 (例如 TvShowMediaMetadata, MovieMediaMetadata, MusicTrackMediaMetadata， 依此類推

在下列程式碼片段中，我們使用 MediaMetadata 物件來指定 每個節目的開始時間 UNIX 時間戳記，加上 sectionStartAbsoluteTime。 資源。節目時間長度以秒為單位。

// The metadata for a single TV show
const currentShow = new cast.framework.messages.TvShowMediaMetadata();
currentShow.episode = 15;
currentShow.seriesTitle = 'The Odyssey';
currentShow.title = 'Scylla and Charybdis';
currentShow.sectionStartAbsoluteTime = toUnixTimestamp('9:00 PM');
currentShow.sectionDuration = HOUR_IN_SECONDS;

const previousShow = new ...;
const nextShow = new ...;

const containerMetadata = new cast.framework.messages.ContainerMetadata();
containerMetadata.title = 'My TV Channel';
containerMetadata.sections = [previousShow, currentShow, nextShow];

playerManager.getQueueManager().setContainerMetadata(containerMetadata);

可搜尋的直播範圍

Cast SDK 包含 UI 元素和控制項，可讓使用者移動 透過 展開的控制器 或觸控設定，

LiveSeekableRange敬上 代表使用者可在串流中跳轉的時間範圍。每月中的特定幾天 Web Receiver 可透過 PlayerManager.getLiveSeekableRange()、 會傳回 LiveSeekableRange。 物件。需留意的物件主要屬性如下：

  • start — 相對於時間範圍的開始時間 (以秒為單位) 就能快速開始串流播放
  • end：玩家可跳轉的最長時間 (以秒為單位)。 根據可用的區隔 (相對於串流開頭)。
  • isMovingWindow — 指出可搜尋範圍的布林值 (例如，舊區段從資訊清單中移除) 這對於所有直播活動來說都應設為 true。
  • isLiveDone - 表示直播是否具有 完成後，系統就不會產生新區隔

可搜尋範圍的大小，以 start 與 end，取決於串流中可用的區段數量， 隨著訊息串移動舉例來說，若在串流開頭處 範圍是 {start:0, end: 600, isMovingWindow: false, isLiveDone: false}，10 開始後幾秒內可變為 {start: 10, end: 610, isMovingWindow: true, isLiveDone: false}。請務必注意起始和 可搜尋範圍的結束時間會根據所需執行時間 可產生新區隔所以如果直播的片段長度一般 10 秒內，開始和結束時間大約每 10 秒更新一次

停用跳轉功能

如要停用串流中的跳轉功能，請先移除跳轉功能 從 Web 接收器上的支援媒體指令執行：

// disable seeking in the LOAD messageInterceptor
playerManager.removeSupportedMediaCommands(cast.framework.messages.Command.SEEK, true);

移除 SEEK 支援的媒體指令給傳送端應用程式 和觸控顯示功能可停用跳轉功能，但不會停用這類語音指令 例如「Ok Google，倒轉 30 秒」 支援的媒體指令 指南，進一步瞭解如何停用語音指令的媒體指令。

即時架構活動

第 2 個事件 (LIVE_ENDED 和 LIVE_IS_MOVING_WINDOW_CHANGED) 包含在 Live API這兩個事件都會透過 LiveStatusEvent敬上 物件，其中包含目前即時搜尋範圍。

活動 說明
LIVE_ENDED 在直播結束時觸發。此時，LiveSeekableRange 中的 end 值會停止更新；使用者仍可在直播可搜尋範圍內觀看內容。
LIVE_IS_MOVING_WINDOW_CHANGED 在直播的可跳轉範圍從固定視窗變更為移動視窗時觸發，反之亦然。以直播來說，如果玩家偵測到資訊清單正在移除先前的片段，就會發生這種情況。

直播情境

直播有多種可能的情境 來建立以下三項核心設定：

  • 串流設有開始時間
  • 直播設有結束時間
  • 使用者可以在直播的可搜尋視窗中跳轉

如需瞭解如何設定，請參閱新增節目指南資料。 這些值。

以下說明直播功能支援的情境和螢幕截圖 也能使用 Google Cloud CLI 或 Compute Engine APIT1 和 T2 變數是用來代表 也就是使用者介面的左側和右側

開始時間 結束時間 可搜尋 T1 T2
情境 1 否 否 否 遊戲頭像 未顯示
情境 2 否 否 有 遊戲頭像 未顯示
情境 3 否 有 否 遊戲頭像 未顯示
情境 4 否 有 有 遊戲頭像 未顯示
情境 5 有 否 否 顯示開始 TIme 遊戲頭像
情境 6 有 否 有 顯示開始 TIme 遊戲頭像
情境 7 是 是 否 顯示開始時間 顯示結束時間
情境 8 是 是 是 顯示開始時間 顯示結束時間

情境一

開始時間 結束時間 可搜尋 T1 T2
否 否 否 播放頭部 未顯示

情境 1 沒有開始或結束時間，且使用者無法在 串流。使用者停止串流後，系統會從直播邊緣繼續播放 本次串流暫停的時間

情境七

顯示 Chromecast 對情境 7 的直播 UI 畫面 (含時鐘時間) 手機顯示了情境 7 的直播 UI 和時鐘時間

開始時間 結束時間 可搜尋 T1 T2
是 是 否 遊戲頭像 課程持續時間

情境 7 有開始時間和結束時間，但無法搜尋。兩者 UI 中的時間戳記 (T1 和 T2) 代表目前的播放頭時間和總計 課程時間長度。當使用者暫停/繼續播放串流時 就能在直播邊緣繼續播放上述例子中的紅色部分 跳轉列代表使用者開始直播後的畫面 觀看。

情境八

顯示 Chromecast 的 情境 8 直播 UI 畫面 (含時鐘時間) 一支手機顯示了情境 8 的即時 UI，以及「時鐘時間」

開始時間 結束時間 可搜尋 T1 T2
是 是 是 遊戲頭像 課程持續時間

情境 7 有開始時間、結束時間，且可搜尋。兩個時間戳記 UI 中的 T1 和 T2 代表目前的播放頭時間和整個節目 時間長度。如果使用者暫停/繼續播放，串流就會繼續播放 暫停時，位於可跳轉的時間區間內，也就是紅色的區域 跳轉滑桿代表使用者可返回某個位置，並以白色顯示該區域 代表可以跳轉至的時間點

設定情境

將直播設定為特定直播情境時，可分為下列三個部分：

  1. 設定串流類型：將串流標示為 直播。
  2. 新增計畫指南資料：設定開始時間 MediaMetadata 物件中的時間長度和持續時間。
  3. 設定跳轉功能 - 啟用或 停用跳轉功能。

播放行為

暫停期間，UI 仍會更新播放中繼資料， 包括播放頭和即時邊緣時間繼續播放串流後 幾項需要注意的行為，會因串流設定而異。

可搜尋串流

恢復可搜尋的串流時：

  • 上線邊緣應更新為即時位置和可搜尋範圍 報表將隨之調整
  • 如果播放頭跳到目前節目，系統就會更新進度列 替換成新節目的中繼資料 (如有，則包括開始時間和結束時間， 可用)。
  • 如果可跳轉的視窗長度為「X」，可跳轉的範圍會延後到 最多「X」，或到節目開頭 (以較小者為準)。
  • 使用者暫停的時間太久，導致目前時間脫離 可跳轉的視窗，串流會在最快的時間點 (最左側) 繼續播放 也就是可跳轉的視窗

跳轉至 LiveSeekableRange.end敬上 取消暫停後，從直播邊緣繼續播放。

let playerManager = cast.framework.CastReceiverContext.getInstance().getPlayerManager();
// Intercept the message to PLAY
playerManager.setMessageInterceptor(cast.framework.messages.MessageType.PLAY, (requestData) => {
  ...
  if (playerManager.getLiveSeekableRange()) {
    // Resume playback at the live edge
    playerManager.seek(playerManager.getLiveSeekableRange().end);
  } else {
    return requestData;
  }
  ...
});

無法瀏覽的直播影片

恢復無法瀏覽的串流時：

  • 在這種情況下，直播會在直播邊緣繼續播放。
  • 如果直播邊緣跳離目前節目，則進度控制列應該 以新節目的中繼資料 (包括開始時間和結束時間) 更新影片內容 (如有)。

API 介面異動和自訂 Live UI

Cast SDK 內建支援建立自訂使用者介面的功能，而不是支援 立即使用立即可用的 UI不過，請務必遵循 自訂 Cast 使用者體驗設計檢查清單 存取 API

網路接收端

Web 接收器： PlayerData敬上 加入下列欄位，方便開發人員擴充自訂欄位 直播介面：

  • isLive - 標記表示目前串流是否為直播活動。 而不是隨選影片
  • liveSeekableRange - 螢幕分界要顯示的可搜尋範圍 DVR 視窗
  • mediaStartAbsoluteTime - 從絕對時間開始的區段開始 (UNIX Epoch 時間)。
  • sectionStartTimeInMedia - 根據 媒體開始時間。
  • sectionDuration - 部分的時間長度 (以秒為單位)。

另外，請務必考量 兩個現場直播。

Android SDK

只要是「直播」功能，系統都會在 UIMediaController 已淘汰，請改用 CastSeekBar。

上一頁
廣告插播時間點
下一頁
次要圖片