使用媒體遙控器測試應用程式

透過語音與 Android 手機上的 Google 助理互動媒體應用程式、 車輛、電視和耳機採用 Android 媒體工作階段 API,並使用媒體動作。 媒體操作生命週期可能難以追蹤。即使只是從搜尋頁面輕鬆播放 要求中有許多中間步驟,可能發生錯誤,如 簡化的時間軸:

媒體行動生命週期

圖 1. 媒體行動生命週期

媒體控制器測試 (MCT) 應用程式可讓你在 Android 上測試媒體播放的細節 檢查媒體工作階段的導入狀態。

MCT 會顯示應用程式 MediaController 的相關資訊,例如 PlaybackState 和中繼資料,可用來測試跨應用程式媒體控制項。 MCT 也提供驗證測試 這個架構 可讓您自動執行品質確保測試

如要使用 MCT,應用程式必須具有媒體瀏覽器服務 而且必須允許 MCT 連結你的 Merchant Center 帳戶詳情請見 建構媒體瀏覽器服務 瞭解詳情

啟用 MCT

MCT 上市頁面
圖 2.MCT 上市頁面

啟動 MCT 時,您會看到兩份清單:

  • Active MediaSessions:啟動 MCT 時,這份清單一開始沒有任何內容 系統隨即會顯示「找不到媒體應用程式」訊息通知 必須具備事件監聽器權限,才能掃描有效的媒體工作階段。」按一下「設定」即可 請前往權限畫面,為 MCT 啟用權限。
  • MediaBrowserService Implementations (MediaBrowserService 實作項目):這份清單顯示實作媒體瀏覽器服務的應用程式, 如果已實作媒體瀏覽器服務,您的應用程式就會出現在這份清單中。 但您必須先將應用程式設定為接受所有 或將 MCT 加入許可清單。請參閱使用 onGetRoot() 瞭解詳情

手動測試手機應用程式

如果您允許 MCT 連結至應用程式的媒體瀏覽器服務,您的應用程式 會出現在媒體瀏覽器服務清單實作清單中。在這裡尋找 接著按一下「Control」即可在背景啟動應用程式。

否則,您必須先自行在背景啟動應用程式,然後按一下 掌控廣告出現在有效媒體工作階段清單的時機。

測試準備工作

當 MCT 開始控制您的應用程式時,系統會顯示應用程式目前的工作階段 metadata:目前選取的媒體,以及工作階段所採取的行動 來處理這些作業

控制頁面
圖 3.控制組頁面

「MCT 控制項」頁面頂端的下拉式選單可讓您選取 SearchURIMedia IDNone,以及文字欄位 ,藉此指定與搜尋、URI 或媒體 ID 相關聯的輸入資料 (如有) 請選取其中一個選項

文字欄位下方的「Prepare」和「Play」按鈕會執行 適當的呼叫 (onPrepare()onPrepareFromSearch()onPrepareFromUri()onPrepareFromMediaId()onPlay()onPlayFromSearch()onPlayFromUri()onPlayFromMediaId())。

測試音訊焦點

運作良好的媒體應用程式應能處理音訊 重點:你可以透過以下方法測試音訊焦點 搭配您的應用程式運作其他音訊應用程式「MCT 控制項」頁面提供 按鈕,用於要求及釋出音訊焦點

如要測試音訊焦點,請按照下列步驟操作:

  1. 使用「音訊焦點」下拉式選單,從三個時間長度提示中擇一使用 AUDIOFOCUS_GAINAUDIOFOCUS_GAIN_TRANSIENTAUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK
  2. 按下按鈕即可要求焦點。
  3. 再次按下按鈕即可放開焦點。

測試傳輸控制項

測試傳輸控制項
圖 4.測試傳輸控制項

向左滑動即可顯示 MCT 的 UI 檢視畫面。這個檢視畫面 內含標準媒體控制器傳輸按鈕,並顯示工作階段的 程式映像檔和資料已停用的交通按鈕會圈出 橘色。其他篩選器皆為有效狀態。

使用傳輸按鈕測試玩家。傳輸按鈕的狀態 內容會如預期變更例如,當您按下「播放」按鈕時 ,[暫停] 和 [停止] 按鈕就會變成啟用狀態。

再次向左滑動,查看會顯示選用動作的檢視畫面。每個動作 但設有一個控制項,顯示抵免額是否處於有效狀態。如果啟用,您即可 只要按一下動作即可執行該動作

如果您從有媒體瀏覽器服務的應用程式清單中進行連結,現在可以 再向左滑動兩次可查看檢視畫面,藉此上下移動應用程式內容 類別,或是搜尋內容樹狀結構

手動測試影片應用程式

請使用分割畫面模式測試影片應用程式控制器。首先,開啟影片應用程式 ,然後以分割畫面模式開啟 MCT。

執行驗證測試

驗證測試架構提供一鍵測試,讓您在測試時 確認您的媒體應用程式能正確回應播放要求。

測試手機應用程式

「測試」按鈕
圖 5.「測試」按鈕

如要進行驗證測試,請點選媒體旁的「測試」按鈕 應用程式。

MCT 狀態

媒體控制狀態
圖 6.媒體控制狀態

下一個檢視畫面會顯示 MCT MediaController 的詳細資訊。 例如 PlaybackState、中繼資料和佇列。有兩個按鈕 按一下左側的按鈕可在 parsable 之間切換 以及格式化記錄右側的按鈕可重新整理檢視畫面,讓系統顯示 以及最新的資訊

選取測試

測試選擇頁面
圖 7.測試選項頁面

向左滑動即可查看驗證測試檢視畫面 查看可捲動的可用測試清單如果測試使用查詢 (例如 圖 7 顯示搜尋測試的結果 輸入查詢字串的文字欄位。

MCT 包含下列媒體動作的測試,以及更多 持續新增至專案:

  • 播放
  • 透過搜尋結果播放
  • 從媒體 ID 播放
  • 從 URI 播放
  • 暫停
  • 停止
  • 跳到下一個
  • 跳至上一個
  • 跳至佇列項目
  • 跳轉至

測試結果

測試成功的結果
圖 8.測試結果成功

檢視畫面底部的結果區域一開始沒有任何內容。該頁面會顯示 因此,當您執行測試時會產生結果舉例來說,若要透過搜尋測試執行播放, 在文字欄位中輸入搜尋查詢,然後按一下「執行測試」。下列 螢幕截圖顯示測試結果成功。

測試 Android TV 應用程式

在 Android TV 上啟動 MCT 時,系統會顯示已安裝的媒體應用程式清單。 請注意,只有實作媒體瀏覽器的應用程式才會顯示在這份清單中 課程中也會快速介紹 Memorystore 這是 Google Cloud 的全代管 Redis 服務

MCT 在電視上推出頁面

圖 9.MCT 在電視上放送頁面

選取應用程式即可前往測試畫面,右側會顯示驗證測試清單。

電視上的驗證測試頁面

圖 10.電視上的驗證測試頁面

執行測試時,畫面左側會顯示 已選取 MediaController詳情請參閱 Logcat 中的 MCT 記錄。

電視上的測試資訊頁面

圖 11.電視上的測試資訊頁面

需要查詢的測試會以鍵盤圖示標示。點選其中一個 這些測試會開啟查詢的輸入欄位。按一下「Enter」即可執行測試。

您也可以使用 adb 指令,以更輕鬆的方式輸入文字:

adb shell input text your-query

您可以使用「%s」即可在字詞之間加上空格例如,下列 指令會新增「hello world」輸入欄位的值

adb shell input text hello%sworld

建立測試

您可以提交提取要求,納入更多您認為實用的測試。 若要瞭解如何建立新的測試,請參閱 MCT GitHub 維基 並查看 驗證測試 操作說明

請參閱捐款說明

其他資源

MCT 必須與實作媒體 API 的應用程式搭配使用。 詳情請參閱 Android 通用音樂播放器 例如應用程式

您可以隨時修正錯誤及提升效能。詳情請參閱 捐款操作說明