
本文由 CocoaChina 譯者呆萌院長翻譯自蘋果開發者中心,校對:hyhSuper。原文為《App Programming Guide for tvOS — The New Apple TV》。
提示:本文屬於預發布版本文檔,描述的是尚在演進中的 API 與技術。蘋果公開它的目的,是幫助開發者提前規劃技術選型與界面設計。內容後續可能調整,因此基於本文的開發工作最終仍需在正式版系統與正式文檔上驗證。
新一代 Apple TV 的定位早已超出「被動的媒體播放設備」。用戶可以在上面玩遊戲、使用工具類應用、看電影,並分享彼此的體驗。這些能力的擴張,也為開發者打開了新的機會窗口。
tvOS 由 iOS 開發體系延伸而來,但並不完全等同。它既沿用了大量熟悉的技術與支持框架,也引入了 tvOS 獨有的能力,讓客廳這一多用戶、共享式的場景成為全新的設計對象。你可以從零開始寫一個新應用,也可以把已有的 iOS 代碼作為起點。無論哪條路,工具鏈都是熟悉的:Xcode、Objective-C、Swift 與 JavaScript。
如果選擇移植現有項目,可以在同一個 Xcode 工程中新增一個 target 以便共享代碼與資源,但 storyboard 需要為 tvOS 重新設計。移植的關鍵在於理解用戶「如何瀏覽」你的應用,並据此重塑界面,建議配合 Apple TV Human Interface Guidelines 一起閱讀。
配置文件的創建方式與 iOS 完全一致:在 Xcode 中使用 Fix Issue,或到開發者中心網站手動生成。具體支持哪些能力,可參考 Supported Capabilities。
值得留意的是,iOS 與 tvOS 應用在本質上是兩個獨立的二進制產物,無法共用同一個包;但你可以為它們建立通用購買(Universal Purchase),用戶一次付費即可同時獲得兩個版本。細節見 App Distribution Guide。
新一代 Apple TV 的硬件配置如下:
新遙控器提供兩種輸入方式:語音(Siri)與觸控搜索。Siri 搜索首批支持以下國家與地區:澳大利亞、加拿大、法國、德國、日本、西班牙、英國、美國。
圖 1-1 新遙控器按鈕說明

為 Apple TV 開發應用與 iOS 開發高度相似,你可以沿用相同技術與框架,構建遊戲、工具、媒體及各類應用,並同時部署到 iOS 與新 Apple TV。
C-S 應用的核心目標是用 HTTPS、XMLHttpRequest、DOM 與 JavaScript 完成流媒體內容的傳輸與呈現。界面由蘋果自定義的標記語言 TVML 描述,行為由 JavaScript 定義,而 TVMLKit 框架負責在原生代碼與腳本之間架橋。
具體做法是:在 JavaScript 文件中定義應用的首次啟動行為,正常打包二進制,再由 TVMLKit 加載該腳本;腳本進而加載 TVML 頁面並渲染到屏幕。蘋果提供了大量現成模板,每種模板對應一種獨特的全屏信息布局,你可以通過增刪模板元素來調整呈現效果。完整清單見 Apple TV Markup Language Reference。
Apple TV 上的所有視頻回放都建立在 HTTP Live Streaming 與 FairPlay Streaming 之上,相關規範可參考 HTTP Live Streaming 和 FairPlay Streaming Overview,以及 HLS Authoring Specification for Apple TV。
用戶可以在 App 菜單頂行放置最多 5 個應用圖標。當某個圖標被選中時,屏幕頂部會展示該應用的內容區域,這就是 Top Shelf。它把「預覽」與「快捷跳轉」合併成一塊黃金位置,值得認真對待。
當用戶把焦點停在某個元素上但尚未選中時,該 UI 元素即處於聚焦狀態。若聚焦對象是一張分層圖片,圖片會隨用戶在玻璃觸控板上的滑動而傾斜響應。
各圖層以略有差異的速度位移,形成視差錯覺,營造出真實的縱深感,讓畫面更有活力,同時明確地告訴用戶「你正在操作的就是它」。
視差素材由設計師產出,而接入成本很低:改進後的 UIImageView 原生支持視差圖片,多數情況下只需少量代碼調整。具體做法取決於圖片是打包進應用,還是運行時從服務器加載。
tvOS 繼承了大量 iOS 框架(部分存在細微差異),包括:Accelerate、AudioToolbox、AudioUnit、AVFoundation、AVKit、CFNetwork、CloudKit、CoreBluetooth、CoreData、CoreFoundation、CoreGraphics、CoreImage、CoreLocation、CoreMedia、CoreSpotlight、CoreText、CoreVideo、Darwin、Foundation、GameController、GameKit、GameplayKit、GLKit、ImageIO、MachO、MediaAccessibility、MediaPlayer、MediaToolbox、Metal、MetalKit、MetalPerformanceShaders、MobileCoreServices、ModelIO、OpenGLES、SceneKit、Security、simd、SpriteKit、StoreKit、Swift Standard Library、SystemConfiguration、UIKit。
Apple TV 沒有鼠標,也不支持觸屏手勢。用戶的一切操作都通過 Siri Remote 或遊戲控制器完成,這意味著「焦點」取代「光標」成為交互的中心。
更根本的變化發生在場景層面。Mac 與 iOS 本質上是單人設備,而客廳裡可能同時坐著幾個人一起參與。優秀的 tvOS 應用必須把這種社交屬性納入設計考量,而不是簡單地把手機界面放大。
Apple TV 應用的包體上限為 200 MB;此外,通過 NSUserDefaults 使用的永久本地存儲最多僅 500 KB。
除這部分外,其餘數據都必須視為「隨時可能被系統清理」。可行的資源策略有三種:
換句話說,為新 Apple TV 開發的每個應用,都應該具備在 iCloud 中存取的完整能力,這是保證體驗的下限。
當你需要編寫僅在 tvOS 生效的代碼時,使用 #define TARGET_OS_TV 1 進行條件編譯。