參考電視應用

某些類別的 Android TV 設備(例如平板電視和運營商機頂盒)需要播放直播電視內容的電視應用程序。參考電視應用程序 ( Live TV ) 與 Android 平台一起提供,可以自定義、擴展或替換。源代碼可在 Android 開源項目中找到。

本文總結瞭如何為您的 Android 電視設備構建和自定義基於 Live TV 的系統 TV App。 (您可以擴展您的電視應用程序以實現設備製造商或特定國家/地區的功能,但這不在參考電視應用程序的範圍內。)

依賴項

TV 應用程序是TV Input Framework (TIF) 的一個組件,不能獨立於其他組件使用。這意味著只有具有 TIF 的設備才能運行Live TV應用程序。

Live TV 應用程序依賴於 Android API。不同的分支對 API 級別的依賴不同:

表 1.直播電視分支。

分支目標 API 級別最低 API 級別
掌握24 (安卓 7.0) 23
安卓直播電視23 (安卓 6.0) 21
android-live-tv-l-mr1 22 (安卓 5.1) 21

獲取源

要開始使用,請從 Git 中選擇您想要的 Live TV 版本。以下說明適用於 Live TV 的當前版本,但您可以通過將分支從主分支更改為上表中列出的其他分支來輕鬆選擇早期版本。

mkdir live-tv && cd live-tv
repo init -u https://android.googlesource.com/platform/manifest -b master
repo sync -j8 -c

建造

要構建直播電視代碼,請運行:

. build/envsetup.sh
tapas LiveTv x86
make LiveTv

將直播電視推送到您的測試設備:

adb install -r -d $OUT/system/priv-app/LiveTv/LiveTv.apk

如果開發者希望 LIVE TV 應用程序擁有系統權限,則第一次安裝時需要將其推送到 /system/priv-app 中:

adb push $OUT/system/priv-app/LiveTv/LiveTv.apk  /system/priv-app/LiveTv/

測試

在您的設備上安裝直播電視後,您應該測試它是否已正確集成。除了為 TV 應用程序運行兼容性測試套件CTS 驗證程序測試之外,您還可以使用以下這些測試:

單元測試

Live TV 應用程序有單元和功能測試。您必須連接設備(或模擬器)才能運行測試。

adb shell logcat -c
m LiveTv TVTestInput TVUnitTests -j20 &&\
adb install -r -d $OUT/system/priv-app/LiveTv/LiveTv.apk &&\
adb install -r -d $OUT/system/app/TVTestInput/TVTestInput.apk && \
adb install -r -d $OUT/data/app/TVUnitTests/TVUnitTests.apk && \
adb shell pm clear com.android.providers.tv && \
adb shell pm clear com.google.android.tv && \
adb shell am instrument \
  -e testSetupMode unit \
  -w com.android.tv.testinput/.instrument.TestSetupInstrumentation &&\
adb shell input keyevent KEYCODE_HOME &&\
adb shell am instrument \
  -w 'com.android.tv.tests/android.support.test.runner.AndroidJUnitRunner'

功能測試

adb shell logcat -c
m LiveTv TVTestInput TVFuncTests -j20 &&\
adb install -r -d $OUT/system/priv-app/LiveTv/LiveTv.apk &&\
adb install -r -d $OUT/system/app/TVTestInput/TVTestInput.apk && \
adb install -r -d $OUT/data/app/TVFuncTests/TVFuncTests.apk && \
adb shell pm clear com.android.providers.tv && \
adb shell pm clear com.google.android.tv && \
adb shell am instrument \
  -e testSetupMode func \
  -w com.android.tv.testinput/.instrument.TestSetupInstrumentation &&\
adb shell input keyevent KEYCODE_HOME &&\
adb shell am instrument \
  -w 'com.android.tv.tests.ui/android.support.test.runner.AndroidJUnitRunner'

Jank 測試

Jank 測試查找丟幀和渲染延遲。

adb shell logcat -c
m LiveTv TVTestInput TVJankTests -j20 &&\
adb install -r -d $OUT/system/priv-app/LiveTv/LiveTv.apk &&\
adb install -r -d $OUT/system/app/TVTestInput/TVTestInput.apk &&\
adb install -r -d $OUT/data/app/TVJankTests/TVJankTests.apk &&\
adb shell pm clear com.android.providers.tv &&\
adb shell pm clear com.google.android.tv &&\
echo "Creating a lot of channels and EPG data, this may take a while" &&\
adb shell am instrument \
  -e testSetupMode jank \
  -w com.android.tv.testinput/.instrument.TestSetupInstrumentation &&\
adb shell input keyevent KEYCODE_HOME &&\
adb shell am instrument \
  -w 'com.android.tv.tests.jank/android.support.test.runner.AndroidJUnitRunner'