您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發基礎

Apple TV 編程指南:用遙控器與焦點引擎控制用戶界面

編輯:iOS 開發基礎

本文由 CocoaChina 譯者呆萌院長(博客)翻譯自蘋果開發者中心。

校對:hyhSuper(GitHub)

原文:App Programming Guide for tvOS: Building Apple TV Apps--Controlling the User Interface with the Apple TV Remote

本文檔系列文章包括:

  • Apple TV 編程指南:介紹

  • Apple TV 編程指南:創建 Client-Server App

  • Apple TV 編程指南:使用 Apple TV 遙控器控制屏幕上的用戶界面(本篇)

  • Apple TV 編程指南:檢測手勢和按鈕按壓

  • Apple TV 編程指南:設計鍵盤輸入體驗

  • Apple TV 編程指南:使用游戲控制器

  • Apple TV 編程指南:創造視差美術資源

  • Apple TV 編程指南:資源管理


使用 Apple TV 遙控器控制屏幕上的用戶界面

在 iOS 設備上,用戶通過觸屏直接交互;而在 Apple TV 上,用戶使用遙控器進行間接交互:先瀏覽到某個選項,再按遙控器上的按鈕選中它。當用戶選中屏幕上的某個選項時,該選項便成為焦點。焦點是指用戶通過遙控器或其他輸入設備間接操作時,屏幕呈現的外部效果。在以焦點為基礎的交互模型中,屏幕上任一時刻只有單一視圖可以獲得焦點,用戶可以通過瀏覽不同 UI 選項把焦點移動到其他視圖,從而觸發焦點更新。獲得焦點的視圖會成為任何用戶操作的目標事件。例如,當屏幕上的某個按鈕被選中時,遙控器發送的選擇事件便會被觸發。

UIKit 框架只支持以焦點為基礎的交互,在大多數情況下,这种行为只在有意義的地方自動提供。你可以要求以編程方式更新焦點,但無法把焦點往某個方向設置或移動。例如,UIButton 對象有焦點,而 UILabel 對象則沒有。對於自定義用戶界面組件的應用,你需要實現自定義的焦點行為,正如 Supporting Focus Within Your App 所解釋的那樣。UIKit 庫中,如 UIButton、UITextField、UITableView、UICollectionView、UITextView、UISearchBar 以及 UISegmentedControl 都自帶默認焦點。

焦點引擎控制焦點

包含可控制焦點的 UIKit 系統與焦點移動邏輯,統稱為焦點引擎。有許多輸入設備能用戶控制焦點,例如各種類型的遙控器、游戲控制器、模擬器等。在你的應用中,焦點引擎會監聽來自這些不同輸入設備的焦點移動事件;當事件發生時,焦點引擎會自動判斷是否更新焦點並通知你的應用。該系統有助於創造連貫一致的用戶體驗,即為每一個應用中當前及未來的所有輸入方法提供自動支持,並幫助開發者專注於實現應用的獨特行為,而非重復定義基礎導航。

只有焦點引擎才能顯式更新焦點,這意味著並不存在可直接設置焦點或朝特定方向移動焦點的接口。只有在用戶發送移動事件、焦點引擎系統要求更新,或應用主動請求更新時,焦點引擎才會更新焦點。關於如何手動更新焦點,可參閱 Updating Focus Programmatically 一節。

焦點引擎的控制主要是為了確保焦點不會在屏幕上意外移動,並讓其行為在不同應用間保持相似。這既能防止用戶因行為不一致而困惑,也意味著開發者無需自行定制合適的焦點管理方案。

UIFocusEnvironment 協議

焦點引擎通過 UIFocusEnvironment 協議與你的應用通信。UIFocusEnvironment 協議定義了視圖層次結構某個分支的焦點行為。UIKit 庫中遵循該協議的類有 UIView、UIViewController、UIWindow 和 UIPresentationController——換句話說,這些類都直接或間接地控制着屏幕上的視圖。在視圖和視圖控制器中重寫 UIFocusEnvironment 協議方法,你就能在應用中控制焦點行為。

用戶生成的焦點移動

焦點引擎可以根據遙控器或其他輸入設備的事件自動決定焦點應移動到哪裡。用戶可以把焦點朝任意二維方向轉移:上下左右,乃至對角線(若硬件支持)。例如,當用戶左滑時,焦點引擎會嘗試找到當前獲得焦點視圖左側、且具有可獲得焦點特性的視圖;若找到新視圖,焦點便移動過去,否則停留在當前激活的視圖。

如果輸入設備支持,焦點引擎還能自動處理複雜行為。例如基於運動的遙控滑動,會根據焦點速度調節相關動畫的速度、播放導航音效,並在焦點移出屏幕時更新滾動視圖偏移。關於焦點相關動畫的更多信息,可參看 UIFocusAnimationCoordinator 類參考。

決定在哪裡移動焦點

在決定如何按用戶動作移動焦點時,焦點引擎需要了解應用內部的用戶界面,以及所有具有可獲得焦點特性的視圖的可視區域。這意味著,如果一個可獲得焦點的視圖完全位於另一個可獲得焦點視圖之下,它就會被忽略而無法獲得焦點;也就是說,只有部分隱藏的視圖,其可見部分才能獲得焦點。利用這一點,焦點引擎從當前獲得焦點的視圖出發,沿運動路徑尋找可獲得焦點的區域,搜索區域的大小與當前焦點視圖的大小直接相關。

圖 3-1 焦點移動

如果焦點引擎找到一個新視圖可以移動焦點,它會在移動發生前給你的應用一個驗證的機會。操作系統會在每個包含上一個和下一個焦點視圖的焦點環境上調用 shouldUpdateFocusInContext: 方法,先通知先前的焦點視圖,再通知焦點視圖,最後通知父視圖。如果所有焦點環境的 shouldUpdateFocusInContext: 都返回 NO,這次焦點移動就會被取消。關於焦點環境的更多知識,參見 UIFocusEnvironment Protocol Reference。

初始焦點和首選焦點鏈

當應用啟動時,焦點引擎會決定一個默認的焦點視圖來獲得焦點,這個視圖通常是距屏幕左上角最近的可獲得焦點視圖。

圖 3-2 分層搜索的初始視圖,以獲得焦點。

不過,通過 UIFocusEnvironment 協議的 preferredFocusedView,你可以為應用提供默認焦點去向的線索。設置初始焦點時,焦點引擎首先詢問 window 的首選焦點視圖,也就是根視圖控制器的 preferredFocusedView 對象。由於返回值是一個符合 UIFocusEnvironment 協議的 UIView 對象,焦點引擎會再詢問它的首選焦點視圖,以此類推。這條由一系列作為返回值組成的首選焦點視圖鏈表,就是首選焦點鏈。焦點引擎沿著這條鏈,直到得到的焦點視圖是它本身或為 nil 為止,並從鏈中最深處選擇下一個可獲得焦點的視圖。

下面這個例子展示了什麼是首選焦點鏈:

  1. 焦點引擎向根窗口查詢 preferredFocusedView,並返回其根視圖控制器的 preferredFocusedView。

  2. 根視圖控制器是選項卡視圖器時,返回它選中視圖控制器的 preferredFocusedView 對象。

  3. 被選中的視圖控制器重寫 preferredFocusedView 方法,返回一個特定的 UIButton 實例。

  4. 這個 UIButton 實例返回 self(默認值),且可獲得焦點,於是被焦點引擎選為下一個焦點視圖。

正如首選焦點鏈所定義的那樣,每當焦點更新到某個指定視圖時,新的焦點視圖都會被設為首選焦點視圖。首選焦點鏈的另一個例子是:當有一個視圖控制器呈現在當前焦點視圖之上時,焦點引擎會用它的首選焦點鏈把焦點更新到新的視圖控制器上。
焦點更新

當用戶行為引起焦點運動時(例如在遙控器上滑動),或應用請求更新焦點、系統自行觸發更新時,就會發生焦點更新。

焦點更新的解析

當焦點更新或移動到一個新視圖時,無論該焦點視圖是子視圖還是位於不同視圖層級,都會發生以下事情:

  • focusedView 屬性被更新,並把更新效果反映到最新的焦點視圖或首選焦點視圖上。

  • 焦點引擎用 didUpdateFocusInContext:withAnimationCoordinator: 方法通知每一個焦點環境,包含先前焦點視圖或下一個焦點視圖(更新後的視圖)的焦點環境。焦點更新時,系統會用動畫協調員安排相關動畫,詳見 UIFocusAnimationCoordinator。

  • 在所有相關焦點環境都收到通知後,所有協調動畫會在同一時刻運行。

  • 如果下一個焦點視圖位於一個滾動視圖上並且在屏幕之外,滾動視圖會滾動到該視圖所在位置,使它移進屏幕內。

系統生成的焦點更新

在許多常見情況下,必要時 UIKit 會自動更新焦點。以下幾個例子展示了系統自動更新焦點的場景:

  • 從視圖層次結構中移除一個焦點視圖。

  • UITableView 或 UICollectionView 重新加載數據。

  • 在當前獲得焦點的視圖上展示一個新的視圖控制器。

  • 用戶按下遙控器上的菜單按鈕回退。

以編程方式更新焦點

通常焦點會在必要時自動更新,但有時你需要主動用代碼引起焦點更新。任何焦點環境都可以通過調用 setNeedsFocusUpdate 方法請求焦點更新,該方法會重置焦點環境的 preferredFocusedView。以下是在應用內部主動更新焦點的一些例子:

  • 當應用內容發生變化、需要留在用戶期望的位置時改變焦點。例如:音樂類應用總希望聚焦當前播放的歌曲,當一首歌結束時,應用應請求更新焦點並移到播放列表的下一首。

  • 用戶期望焦點轉移到某個新位置的操作。例如:一個界面由左右兩部分組成,左邊是菜單,右邊是對應菜單項的內容集合。當用戶在菜單項之間移動時,右邊內容隨之改變;當用戶選中某個菜單項時,可能會期待焦點自動移到該集合的第一項。

  • 獲得焦點的自定義控件在更新內部狀態時需要以某種方式改變焦點。例如:當用戶在遙控器上選中一個選擇器控件時,焦點會移動到它上面,讓用戶選擇一系列選項;按下遙控器菜單又會讓該控件失去焦點。此時,通過 preferredFocusedView,選擇控件會請求把焦點移到它的某個子視圖上。

讓你的 App 支持焦點

如果你的應用使用內置 UIKit 控件,那麼什麼都不用做就能支持焦點:應用啟動時,屏幕上的一個可獲得焦點視圖會被選為初始焦點視圖;在應用整個生命周期中,焦點引擎負責管理焦點。

然而,大多數應用都希望實現某些自定義的焦點行為,例如焦點改變時更新應用狀態、創建新的交互元素類型,或實現自定義的焦點動畫。下面的章節概述了在應用中實現自定義焦點行為支持需要做哪些事。

對一個視圖層次結構的分支來說,UIFocusEnvironment 類控制焦點相關行為。這意味著控制器控制著它的根視圖和子節點視圖的焦點行為,而 UIView 類型對象控制它自己和子節點的焦點行為。因此,多個焦點環境可以控制同一個視圖層次結構分支的焦點行為。所謂視圖層次結構分支,是指視圖既包含其他視圖,又處於視圖控制器之中。控制焦點相關行為並不意味著某個視圖一定獲得焦點,而是意味著焦點環境能控制焦點在其視圖層級上如何移動,以及焦點改變後 UI 如何應對。

在視圖控制器中支持焦點

由於 UIViewController 遵循 UIFocusEnvironment 協議,你的自定義視圖控制器可以重寫 UIFocusEnvironment 的委託方法來實現自定義焦點行為。自定義視圖控制器可以實現如下功能:

  • 重寫 preferredFocusedView 方法,指明焦點默認從哪個視圖開始。

  • 重寫 shouldUpdateFocusInContext: 方法,定義焦點允許移動的位置。

  • 在更新應用內部狀態或焦點更新發生時,重寫 didUpdateFocusInContext:withAnimationCoordinator: 方法來響應焦點更新。

通過調用 setNeedsFocusUpdate 方法,你的視圖控制器可以請求焦點引擎為當前的 preferredFocusedView 重置焦點。注意,只有當視圖控制器包含當前焦點視圖時,調用 setNeedsFocusUpdate 才會生效。

在 Collection 視圖和 Table 視圖中支持焦點

使用 collection 視圖和 table 視圖時,你可以用委託對象定義任何自定義行為。這種模式在實現基於焦點的交互界面時同樣適用。UITableViewDelegate 和 UICollectionViewDelegate 協議聲明的方法和屬性,與 UIFocusEnvironment 協議提供的相似,只不過 tableView 和 collectionView 的協議是規范它們自身行為的。

在 collection 視圖和 table 視圖中支持焦點的提示:

  • 使用 UICollectionViewDelegate 的 collectionView:canFocusItemAtIndexPath: 方法,或 UITableViewDelegate 的 tableView:canFocusRowAtIndexPath: 方法,檢查某個特定的 cell 是否需要焦點。這一行為類似於在自定義視圖中重寫 UIView 的 canBecomeFocused 方法。

  • 當焦點離開當前視圖時,使用 UICollectionView 和 UITableView 都定義的 remembersLastFocusedIndexPath 屬性,檢查焦點是否應返回上一個焦點索引;它指定焦點是否應返回焦點離開時的最後一個索引路徑,然後焦點重新進入 collectionView 或 tableView 視圖。

在自定義視圖中支持焦點

像 UIViewController 和 UIView 類也遵循 UIFocusEnvironment 協議,這意味著 Supporting Focus in View Controllers 文檔中概述的所有功能都能應用到自定義視圖中。但由於視圖可以獲得焦點,實現自定義焦點行為時還需考慮以下幾點:

  • 如果你的自定義視圖需要焦點,重寫 canBecomeFocused 方法並把返回值設為 YES(默認是 NO)。你的視圖可能經常獲得焦點,也可能只在某些情況下才獲得焦點。例如,UIButton 對象的 enable 屬性為 NO 時就無法獲得焦點。

  • 如果焦點必須重新聚焦到另一個視圖(例如某個子視圖),選擇重寫 preferredFocusedView。

  • 在更新應用內部狀態或焦點更新發生時,重寫 didUpdateFocusInContext:withAnimationCoordinator: 方法作為焦點更新後的響應行為。

協調焦點相關動畫

當焦點發生更新時,當前視圖以某種動畫過渡到焦點狀態,之前的焦點視圖以某種動畫過渡到非焦點狀態,更新後獲得焦點的視圖則以某種動畫過渡到焦點狀態。然而,這些動畫與應用中定義的普通動畫不同——為實現某些系統級行為,UIKit 會讓焦點相關動畫的曲線軌跡和運動時間相適應。例如,當焦點快速移動時,動畫時間會縮短以跟上用戶的移動。

UIKit 為系統定義的、可獲得焦點的視圖類提供了焦點動畫。使用 UIKit 內置的 UIFocusAnimationCoordinator 類和 addCoordinatedAnimations:completion: 方法,你可以創建帶有系統級行為的自定義動畫。

根據協調器提供的焦點環境,被添加到協調器中的動畫可以作為正在獲取焦點的動畫中的邊緣動畫、失去焦點中的動畫,或兩者都不是。一般來說,獲得焦點和失去焦點的父視圖,以及特殊焦點視圖的父視圖,都會沿著獲得焦點的方向做動畫;而非焦點視圖獨有的父視圖則會做失去焦點的動畫。

圖 3-3 自定義焦點動畫

通常,視圖會根據自己是正在得到焦點還是失去焦點而擁有不同的動畫。通過重寫視圖的 didUpdateFocusInContext:withAnimationCoordinator: 方法並檢查上下文中的當前焦點狀態,你可以指定視圖需要哪種動畫。下面是重寫該方法的例子。

- (void)didUpdateFocusInContext:(UIFocusUpdateContext *)context withAnimationCoordinator:(UIFocusAnimationCoordinator *)coordinator {     [super didUpdateFocusInContext:context withAnimationCoordinator:coordinator];       if (self == context.nextFocusedView) {         [coordinator addCoordinatedAnimations:^{             // focusing animations         } completion:^{             // completion         }];     } else if (self == context.previouslyFocusedView) {         [coordinator addCoordinatedAnimations:^{                // unfocusing animations             }         completion:^{                // completion         }];     } }

非焦點和焦點視圖共同的父視圖,可以為焦點視圖和非焦點視圖一起關聯相關動畫。例如,一個 UICollectionView 對象可以把之前獲得焦點的 cell 與將要獲得焦點的 cell 一起做動畫。在 UICollectionViewCell 的子類情況下,推薦使用類似上面代碼片段的邏輯,並在子類中實現動畫代碼。

調試焦點問題

應用運行時,UIKit 能幫助你調試焦點問題。

為什麼這個視圖不能獲得焦點?

一個本應獲得焦點的視圖卻無法獲得焦點,原因有很多種,以下列舉幾種可能(並非全部):

  • 視圖的 canBecomeFocused 方法返回值為 NO。

  • 視圖的 hidden 屬性值設置為 YES。

  • 視圖的透明度屬性值為 0。

  • 視圖的用戶交互被禁用。

  • 該視圖被它上面的視圖完全遮蓋。

UIKit 提供了 UIView 類的一個隱藏方法——_whyIsThisViewNotFocusable,旨在幫助排查上述常見情況。僅在調試某個特定視圖引用時調用該方法,它就會打印出一份可讀性良好、可能導致問題的原因列表,如下所示:

為什麼焦點移動到你沒有想到的某個地方?

有時候焦點並沒有移動到你期待的地方,甚至根本沒動。焦點引擎提供了很多便利,有時你最好多了解一些它是如何移動焦點的。

UIKit 會發送一個 UIFocusUpdateContext 實例對象,用可視化的方式呈現焦點引擎在 Quick Look 中如何搜尋下一個焦點視圖。想看到這個場景,可以在 shouldUpdateFocusInContext: 或 didUpdateFocusInContext:withAnimationCoordinator: 方法中設置斷點,當程序運行到該斷點時,在調試台中選中 context 參數並打開 Quick Look 菜單選項。

圖 3-4 在調試器中選擇上下文參數

如果斷點在焦點運動過程中(而非焦點更新時)被執行,Quick Look 會展示一張圖片來表達搜索引擎找到下一個焦點視圖的搜索路徑,例子見圖 3-5。

圖 3-5 快速尋找一個圖像顯示

下面是 Quick Look 中圖片可能展示的幾種信息:

  • 以前的焦點視圖(搜索的起點視圖),顯示在紅色區域。

  • 搜索路徑輪廓,用虛線標注。

  • 任何在搜索路徑中可獲得焦點的 UIView 對象區域,顯示紫色。

  • 任何在搜索路徑中可獲得焦點的 UIFocusGuide 類區域,顯示藍色。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved