
本文由 CocoaChina 譯者呆萌院長翻譯自蘋果官方開發者文檔,校對:hyhSuper。原文為《App Programming Guide for tvOS: Building Apple TV Apps — Creating a Client-Server App》。
與傳統原生應用不同,Client-Server(以下簡稱 C-S)應用的界面並非全部寫死在客戶端。Xcode 工程承擔的角色相當輕量:它只需要找到並加載一個主 JavaScript 文件,之後所有頁面都由 TVML 文件動態生成,再渲染到電視屏幕上。
下圖展示了典型的 C-S 模型。

JavaScript 負責加載 TVML 頁面,並把頁面壓入導航堆棧。用戶在應用中逐層瀏覽時,頁面不斷入棧與出棧;當用戶退出應用,系統便回到 Apple TV 主屏幕。整體流程如下圖所示。
圖 2-2 C/S 應用運行流程

提示:關於網絡安全配置的更多說明,可參考 Apple 的 App Transport Security Technote。
class AppDelegate: UIResponder, UIApplicationDelegate, TVApplicationControllerDelegate。var appController: TVApplicationController?。application(_:didFinishLaunchingWithOptions:)。func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool {
self.window = UIWindow(frame: UIScreen.mainScreen().bounds)
let appControllerContext = TVApplicationControllerContext()
let javascriptURL = NSURL(string: "Enter path to your JavaScript file here")
appControllerContext.javaScriptApplicationURL = javascriptURL!
if let options = launchOptions {
for (kind, value) in options {
if let kindStr = kind as? String {
appControllerContext.launchOptions[kindStr] = value
}
}
}
self.appController = TVApplicationController(context: appControllerContext, window: self.window, delegate: self)
return true
}完成上述改造後,只要 Apple TV 與電腦連通,就能在模擬器或真實電視屏幕上看到加載出來的 TVML 頁面。想深入了解 JavaScript 側的能力,請閱讀 TVJS Framework Reference。
下面的 Listing 2-1 中,JavaScript 加載了一個「是否升級到高級版本」的提示框頁面(Listing 2-2)。頁面準備好之後被推入導航棧,隨即呈現在用戶面前。關於 TVML 的模板與元素,請查閱 Apple TV Markup Language Reference。
Listing 2-1 將 TVML 頁面推入導航棧
function getDocument(url) {
var templateXHR = new XMLHttpRequest();
templateXHR.responseType = "document";
templateXHR.addEventListener("load", function() { pushDoc(templateXHR.responseXML); }, false);
templateXHR.open("GET", url, true);
templateXHR.send();
return templateXHR;
}
function pushDoc(document) {
navigationDocument.pushDocument(document);
}
App.onLaunch = function(options) {
var templateURL = 'Enter path to your server here/alertTemplate.tvml';
getDocument(templateURL);
}
App.onExit = function() {
console.log('App finished');
}Listing 2-2 提示框頁面的 TVML 結構

重要:JavaScript 與 XML 文件通常由 Web 服務器提供,這就帶來一個常見陷阱——頁面更新後,客戶端卻仍在使用舊內容。要避免這種情況,服務器必須在響應頭中明確告知客戶端不要緩存,也就是加上 Cache-Control: no-cache。否則調試時你會為「改了代碼卻沒生效」而抓狂。