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

逐個 API 拆解 iOS 10 新功能:一份不玩空泛的筆記

編輯:iOS 開發綜合

網路上談 iOS 新特性的文章,多半每個功能三兩句帶過,看完還是不知道怎麼用。所以這次換個角度:直接翻頭檔,把 API 層級的用法記下來。原本想畫類圖,後來覺得曠日廢時就算了。

本文依文件目錄推進,涵蓋的模組有:Proactive Suggestions、Integrating with the Messages App、User Notifications、Speech Recognition、Wide Color、Adapting to the True Tone Display、App Search Enhancements、Widget Enhancements、Security and Privacy Enhancements。尚未深入的是 SiriKit、CallKit 與 Apple Pay Enhancements。

SiriKit

能力很強:音訊、視訊、訊息收發、搜尋照片、預訂行程、管理運動紀錄都在射程內。使用時 Siri 會送出 Intent 物件,裡頭裝著使用者請求與各項資料,你決定怎麼回應。相關類別散在 <Intents/Intents.h> 與 <IntentsUI/IntentsUI.h> 兩個框架,數量龐大,等正式版推下來再細看。

Proactive Suggestions 主動建議

iOS 9 時代,系統的主動建議出現在 Spotlight 搜尋、Safari 搜尋、Handoff 與 Siri 建議。iOS 10 又加了鍵盤 QuickType 建議、地圖、車內娛樂、App 切換、Siri 互動與鎖屏播放。

舉例說:使用者在某個 App 裡看一家飯店,你可以用 mapitem 屬性把這個地點存下來,之後他切到旅遊或地圖 App 時,系統就能直接提供這個位置。要讓 Siri 順利調起,記得把經緯度、地名、電話等屬性填齊。

文件列了幾個具體場景:

場景一:輸入框語意提示。在 UITextField 上指定 textContentType,系統就能判斷這是電話還是地址,給出對應建議。可選值都在 <UIKit/UITextInputTraits.h>:

UIKIT_EXTERN NSString *const UITextContentTypeName                NS_AVAILABLE_IOS(10_0);
UIKIT_EXTERN NSString *const UITextContentTypeNamePrefix          NS_AVAILABLE_IOS(10_0);
UIKIT_EXTERN NSString *const UITextContentTypeGivenName           NS_AVAILABLE_IOS(10_0);
UIKIT_EXTERN NSString *const UITextContentTypeMiddleName          NS_AVAILABLE_IOS(10_0);
UIKIT_EXTERN NSString *const UITextContentTypeFamilyName          NS_AVAILABLE_IOS(10_0);
UIKIT_EXTERN NSString *const UITextContentTypeNameSuffix          NS_AVAILABLE_IOS(10_0);
UIKIT_EXTERN NSString *const UITextContentTypeNickname            NS_AVAILABLE_IOS(10_0);
UIKIT_EXTERN NSString *const UITextContentTypeJobTitle            NS_AVAILABLE_IOS(10_0);
UIKIT_EXTERN NSString *const UITextContentTypeOrganizationName    NS_AVAILABLE_IOS(10_0);
UIKIT_EXTERN NSString *const UITextContentTypeLocation            NS_AVAILABLE_IOS(10_0);
UIKIT_EXTERN NSString *const UITextContentTypeFullStreetAddress   NS_AVAILABLE_IOS(10_0);
UIKIT_EXTERN NSString *const UITextContentTypeStreetAddressLine1  NS_AVAILABLE_IOS(10_0);
UIKIT_EXTERN NSString *const UITextContentTypeStreetAddressLine2  NS_AVAILABLE_IOS(10_0);
UIKIT_EXTERN NSString *const UITextContentTypeAddressCity         NS_AVAILABLE_IOS(10_0);
UIKIT_EXTERN NSString *const UITextContentTypeAddressState        NS_AVAILABLE_IOS(10_0);
UIKIT_EXTERN NSString *const UITextContentTypeAddressCityAndState NS_AVAILABLE_IOS(10_0);
UIKIT_EXTERN NSString *const UITextContentTypeSublocality         NS_AVAILABLE_IOS(10_0);
UIKIT_EXTERN NSString *const UITextContentTypeCountryName         NS_AVAILABLE_IOS(10_0);
UIKIT_EXTERN NSString *const UITextContentTypePostalCode          NS_AVAILABLE_IOS(10_0);
UIKIT_EXTERN NSString *const UITextContentTypeTelephoneNumber     NS_AVAILABLE_IOS(10_0);
UIKIT_EXTERN NSString *const UITextContentTypeEmailAddress        NS_AVAILABLE_IOS(10_0);
UIKIT_EXTERN NSString *const UITextContentTypeURL                 NS_AVAILABLE_IOS(10_0);
UIKIT_EXTERN NSString *const UITextContentTypeCreditCardNumber    NS_AVAILABLE_IOS(10_0);

場景二:影音類 App。用 MPPlayableContentManager(<MediaPlayer/MPPlayableContentManager.h>),新增了 nowPlayingIdentifiers 屬性。也就是說,只要你本來就用這套多媒體 API 播放音樂,就能在鎖屏頁面上跟使用者互動,把項目對應填進這個陣列即可。

場景三:出行類 App。MKDirectionsRequest(<MapKit/MKDirectionsRequest.h>)幾乎沒新增 API,只多了一個看起來就是預設值的列舉。要啟用得在 info.plist 補上 MKDirectionsApplicationSupportedModes 對應 MKDirectionsModeRideShare。

User Notifications 使用者通知

這次改動幅度很大。以往的通知是「大家先準備好,然後一次全量發下去,收不收得到也不問」,現在則比較像網路請求:先送 request 再收 response,中間還包了 error,各個狀態都有方法可以插入額外處理,也能取到發送者等欄位。

入口在 <UserNotifications/UserNotifications.h>:

NSString+UserNotifications.h
提供 localizedUserNotificationStringForKey:arguments:,用來取得通知呈現時的在地化字串。底下那些 initWithIdentifier 的 identifier,指的就是這個。

UNError.h
一個 UNErrorDomain 與一個 UNErrorCode 列舉,顧名思義。

UNNotification.h
兩個屬性:date 與 request。request 是 UNNotificationRequest,裡頭有 identifier、content、trigger,以及帶這三者的初始化方法。

UNNotificationAction.h
描述通知上的一個動作:identifier、title、options(列舉,控制權限:允許?拒絕?前台是否顯示?)。另有子類 UNTextInputNotificationAction,多了按鈕標題與輸入框 placeholder——推測就是點通知後展開的快速回覆介面。

UNNotificationAttachment.h
URL(附件資源)與 type(附件類型),加上對應的初始化方法。另外宣告了幾個字串常數:typeHint、hiddenKey、clippingRectKey、TimeKey。

UNNotificationCategory.h
identifier、actions(陣列)、minimalActions(空間不足時只給兩個位置,要顯示哪兩個由你決定)、intentIdentifiers、options(權限相關)。名字取作 category,推測是因為通知中心會把通知分類展示,每類可顯示的數量有限;若開了自訂關閉,可能就是支援一鍵清除那類操作。

UNNotificationContent.h
內容本體,屬性很多:attachments、badge、body、categoryIndentifier、launchImageName(點通知進入時的啟動圖)、subtitle、threadIdentifier、title、userInfo、sound。sound 有 defaultSound 與 soundNamed: 兩個方法,檔案放在 ~/Library/Sounds。子類 UNMutableNotificationContent 屬性相同,但都可寫,父類一律唯讀。

UNNotificationResponse.h
notification 與 actionIdentifier 兩個屬性。子類 UNTextInputNotificationResponse 多了 userText,就是輸入框裡打的字。

UNNotificationSettings.h
一個列舉講有沒有權限,一個講狀態(不支援?停用?啟用?)。底下 badge、sound、lockscreen 等設定都是這個列舉型別,另有 alertStyle(None?Banner?Alert?)。

UNNotificationTrigger.h
repeats 屬性決定是否重複。四個子類分別對應:遠端推送、時間、日曆、地區。時間類有 timeInterval,日曆類有 dateComponents,兩者都有 nextTriggerDate 方法。

UNUserNotificationCenter.h
東西多到眼花。以前是 [NSNotificationCenter defaultCenter],這裡是 [UNUserNotificationCenter currentNotificationCenter],別寫錯。方法多是 add / remove / get 三類,另有兩個 delegate:通知即將送出時、收到 response 後。

UNNotificationServiceExtension.h
兩個方法:收到通知請求時、系統即將銷毀時。

通知相關的 UI 在 <UserNotificationsUI/UserNotificationsUI.h>,只有一個檔案,方法很單純(收到通知、收到回應),加上 mediaPlay、mediaPause 與多媒體按鈕的 frame、color 等。至於 WWDC 2016 提到的鎖屏樣式客製,實際 API 在下面的 Widget 章節。

Integrating with the Messages App

對 Message 的支援幅度很大:可以模擬收發訊息、寄信,也提供了 UI 介面與表情貼圖區域的擴充 API。入口在 <Messages/Messages.h>。

MSMessagesAppViewController.h
蘋果自家的訊息介面,可以繼承它做自己的樣子。屬性有 activeConversation(當前對話)與 presentationStyle(緊縮?擴張?)。方法則是 requestPresentationStyle、dismiss,以及一整套 will / did 生命週期:對話活躍、解除活躍、選擇訊息、收到訊息、開始送出、取消送出、開始轉場。

MSConversation.h
localParticipantIdentifier(本地參與者標識,據說只有刪掉 App 才會變)、remoteParticipantIdentifiers、selectedMessage,以及四個帶成功回呼的方法:插入訊息、插入貼圖、插入文字、插入附件。

MSSession.h
空的,用來處理訊息序列之間的關係,目前像個佔位類別,但後面很多參數都用它當型別。

MSMessage.h
初始化是 initWithSession:。其餘屬性:session、senderParticipantIdentifier、layout、URL、shouldExpire(設為 YES 會自動消失)、accessibilityLabel(無障礙)、error。

MSMessageLayout.h
抽象類,空實作,繼承自 NSObject。

MSMessageTemplateLayout.h
繼承上面那個,應該是後續最常用的版面:標題、子標題、尾部標題、尾部子標題、圖片、多媒體 URL、圖片標題、圖片子標題。

MSSticker.h
貼圖本體,imageFileURL 與 localizedDescription,加上對應的 initWithContentsOfFileURL:localizationDescription:。

MSStickerView.h
包住貼圖的 view。帶 sticker 的初始化方法、animationDuration,以及 startAnimating / stopAnimating / isAnimating。

MSStickerBrowserViewDataSource.h
就是 WWDC 上那個「訊息下方自訂表情區」。兩個方法:numberOfStickersInStickerBrowserView: 與 stickerBrowserView:stickerAtIndex:。

MSStickerBrowserView.h
用上述 data source 的 view,屬性有 stickerSize(小、中、大)、dataSource,另有 reloadData。

MSStickerBrowserViewController.h
承載上面那個 view 的 controller,屬性 stickerBrowserView 與初始化方法。

Messages 模組的 UI 部分在 <MessageUI/MessageUI.h>,只有兩個 VC:MFMailComposeViewController 與 MFMessageComposeViewController,都繼承自 UINavigationController。前者有 canSendMail、設定主題、寄件者、收件者、內容、附件,並透過 mailComposeController:didFinishWithResult:error: 回報結果;後者寫法幾乎一樣。

Speech Recognition 語音轉文字

這塊的 API 設計相當清爽,用起來應該很順手。對語音服務商來說壓力不小——畢竟這是系統原生支援的即時轉寫。

入口在 <Speech/Speech.h>。

SFSpeechRecognitionResult.h
bestTranscription 是最佳轉寫結果(SFTranscription)。SFTranscription 有 formattedString(整段字串)與 segments(切分後的小結果陣列),segment 裡則有 substring、時間戳、duration、可信度與候選答案陣列。

SFSpeechRecognitionRequest.h
taskHint 用來標示請求性質:搜尋?確認?聽寫?不確定?另有兩個 BOOL:shouldReportPartialResults(是否要逐段回報,預設 false 表示整句說完再上傳)、detectMultipleUtterances(十秒的錄音只對上五秒時,前面的要不要留)。還有識別到的關鍵字陣列與標識符。兩個子類:一個從本地 URL 讀音檔,一個用麥克風搭配 AVFoundation 取音。

SFSpeechRecognitionTask.h
語音識別的核心類別。state 表示進行中/已完成/已取消等狀態,另有 isFinishing、isCancelled、error,以及 isPowerAvailable、peakPower、averagePower 三個音量監測相關屬性。delegate 方法涵蓋識別出話語、猜測話語、說完、取消等時機。

SFSpeechRecognizer.h
跟相機、通訊錄權限的概念一樣:查詢目前狀態(同意/拒絕/未選擇)並提供請求方法。屬性有 supportedLocales(支援的語言地區集合)、available、locale、defaultTaskHint、request、queue、delegate,並在權限變動時觸發 delegate。

Wide Color 廣色域

文件大意是:多數以 Core 開頭的繪圖框架與 AVFoundation 都大幅提升了對擴充像素與廣色域色彩空間的支援,UIKit 現在可以在 sRGB 下工作,效能更好,也能搭配更廣的色域。若你的 App 依賴 UIKit 的 clamp component values,或自己用低階 API 做影像處理,建議就用 sRGB。

UIColor 因此多了兩個 iOS 10 的新方法:

+ (UIColor *)colorWithDisplayP3Red:(CGFloat)displayP3Red
                             green:(CGFloat)green
                              blue:(CGFloat)blue
                             alpha:(CGFloat)alpha NS_AVAILABLE_IOS(10_0);

- (UIColor *)initWithDisplayP3Red:(CGFloat)displayP3Red
                            green:(CGFloat)green
                             blue:(CGFloat)blue
                            alpha:(CGFloat)alpha NS_AVAILABLE_IOS(10_0);

一個類別方法、一個實例方法,其餘相同。實務上多數專案會把 RGB 包成巨集,那麼改巨集定義那一處就够了。

Adapting to the True Tone Display 原彩顯示

原彩顯示會依光感應器自動調整,在顯示效果與效能之間取平衡。要啟用需在 info.plist 設定 UIWhitePointAdaptivityStyle,共五種:

1. UIWhitePointAdaptivityStyleStandard(標準)
2. UIWhitePointAdaptivityStyleReading(閱讀)
3. UIWhitePointAdaptivityStylePhoto(圖片)
4. UIWhitePointAdaptivityStyleVideo(視訊)
5. UIWhitePointAdaptivityStyleGame(遊戲)

圖片處理類就配 Photo,閱讀類就配 Reading。這五者的顯示效果由上而下遞減:閱讀時給最好的還划算,遊戲時若也給最好,效能就吃不消了。

App Search Enhancements 搜尋增強

iOS 10 的搜尋多了應用內搜尋、搜尋傳遞、隱私差異考量與結果視覺化。使用 CSSearchQuery 搭配 Core Spotlight,可以不必自己維護搜尋索引,關鍵字處理與跨類別排序都由系統代勞。

搜尋結果還能往下傳遞:例如用 Core Spotlight 搜「火車站」,點進地圖 App 後,該 App 會在內部延續同一組關鍵字。要支援需在 plist 補上 CoreSpotlightContinuation = YES,並設定 CSQueryContinuationActionType(<CoreSpotlight/CSSearchableItem.h>),接收端則用 continueUserActivity:restorationHandler:。

<CoreSpotlight/CSSearchQuery.h> 的結構大致是:initWithQueryString:attributes: 初始化,isCanceled 屬性,cancel 與 start 方法,foundItemCount 可取結果數,protectionClasses 應該與受保護的隱私檔案有關,另有兩個 block 分別在結束時(參數 NSError)與查到結果時(參數 items 陣列)回呼,items 為 CSSearchableItem,其 attributeSet 可帶多種欄位。

Widget Enhancements 鎖屏小工具增強

鎖屏介面改版,建議把舊的 notificationCenterVibrancyEffect 換成 widgetPrimaryVibrancyEffect 或 widgetSecondaryVibrancyEffect,並可對外描述小工具有多少內容可用,支援緊縮與擴張兩種形態。

<NotificationCenter/NotificationCenter.h> 底下有三個檔案:

NCWidgetProviding.h

- (void)widgetPerformUpdateWithCompletionHandler:(void (^)(NCUpdateResult result))completionHandler;

實作這個方法後,系統會在適當時機要求小工具更新,無論在通知中心還是背景。需要開啟背景更新,更新會在子執行緒進行,呼叫完成後回傳結果。

- (void)widgetActiveDisplayModeDidChange:(NCWidgetDisplayMode)activeDisplayMode
                        withMaximumSize:(CGSize)maxSize;

顯示模式改變時呼叫,maxSize 是最大尺寸。這裡宣告了 UIVibrancyEffect (NCWidgetAdditions) 分類:

+ (UIVibrancyEffect *)widgetPrimaryVibrancyEffect   NS_AVAILABLE_IOS(10_0);
+ (UIVibrancyEffect *)widgetSecondaryVibrancyEffect NS_AVAILABLE_IOS(10_0);

兩者都用在選取的文字或圖形上,預設用 primary;若開啟 further diminution(類似壓縮模式)則改用 secondary。

另有 NSExtensionContext (NCWidgetAdditions) 分類,屬性 widgetLargestAvailableDisplayMode 與 widgetActiveDisplayMode 都是 NCWidgetDisplayMode(緊縮、擴張),方法 widgetMaximumSizeForDisplayMode 回傳該模式的最大 CGSize。

NCWidgetController.h

- (void)setHasContent:(BOOL)flag forWidgetWithBundleIdentifier:(NSString *)bundleID;

flag 預設 YES,代表有內容就顯示。這個方法可以用來跨小工具溝通,也能與 providing app 互動。

NCWidgetTypes.h
只有 NCWidgetDisplayMode 一個列舉。

Security and Privacy Enhancements

安全性在 iOS 10 有多項調整:

1. info.plist 新增 NSAllowsArbitraryLoadsInWebContent,允許任意網頁載入,同時由 ATS 保護你的 App。
2. 改用改良後的 SecKey API,CDSA API 已過時。
3. 安全傳輸 API 不再支援 SSLv3,建議停用 SHA1 與 3DES。
4. 剪貼板擴充:既然 WWDC 展示了跨裝置複製貼上,就得加上可見性限制(<UIKit/UIPasteboard.h>)。
5. 最要緊的一點:所有與使用者權限相關的項目都必須在 info.plist 補上用途說明,包括

NSBluetoothPeripheralUsageDescription、NSCalendarsUsageDescription、NSCameraUsageDescription、NSContactsUsageDescription、NSHealthShareUsageDescription、NSHealthUpdateUsageDescription、NSHomeKitUsageDescription、NSLocationAlwaysUsageDescription、NSLocationWhenInUseUsageDescription、NSMicrophoneUsageDescription、NSMotionUsageDescription、NSPhotoLibraryUsageDescription、NSRemindersUsageDescription、NSSiriUsageDescription、NSSpeechRecognitionUsageDescription、NSVideoSubscriberAccountUsageDescription、NSVoIPUsageDescription。

我用模擬器實測過:想叫出通訊錄卻沒配 NSContactsUsageDescription 時,App 啟動不會立刻掛,但一執行到那個操作就直接 crash;補上設定後一切正常。

以上是按我自己覺得清楚的結構整理的筆記,其中摻了幾處推測與理解,不敢保證百分之百正確,若有不同看法歡迎一起討論。

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