Spotlight 這個功能其實很值得做。它讓使用者在系統層級就能搜到你 App 裡的內容,既提升活躍度,也增加內容曝光機會,成本卻不高。
var searchableItems = [CSSearchableItem]() for app in apps { let searchableItemAttributeSet = CSSearchableItemAttributeSet(itemContentType: kUTTypeText as String) searchableItemAttributeSet.title = app.label searchableItemAttributeSet.contentDescription = "Watch \(app.label) LIVE on Shou" let searchableItem = CSSearchableItem(uniqueIdentifier: app.id, domainIdentifier: "youappbundlerid.apps", attributeSet: searchableItemAttributeSet) searchableItems.append(searchableItem) } CSSearchableIndex.defaultSearchableIndex().indexSearchableItems(searchableItems, completionHandler: { (error: NSError?) in if error == nil { print("initSpotlight...completed") } else { print("\(error)") } })
務必把這段放到子線程執行,它比你想像的慢。實務上可以在 AppDelegate 裡等服務器資料回來之後再加索引,避免拖慢啟動。
@available(iOS 8.0, *) func application(application: UIApplication, continueUserActivity userActivity: NSUserActivity, restorationHandler: ([AnyObject]?) -> Void) -> Bool { if #available(iOS 9.0, *) { if userActivity.activityType == CSSearchableItemActionType { if let uniqueIdentifier = userActivity.userInfo?[CSSearchableItemActivityIdentifier] as? String, let label = userActivity.title { // 頁面跳轉 } } } return true }
2.1 CSSearchableItemAttributeSet
不設 thumbnailData 時,系統預設用當前 App 的圖示。另外要注意 thumbnailURL 並不能用來指定網路圖片地址,想顯示縮圖必須先下載到本地再設定。
2.2 CSSearchableItem
預設失效時間約一個月。另外嘗試透過 setValue 掛額外自訂資料,在 userActivity 那端完全收不到,看來目前不支援攜帶更多 payload。
2.3 索引條數上限
翻了一圈沒找到明確限制(相關討論:Stack Overflow)。實測添加索引確實偏慢,那個批量索引介面研究之後的判斷是:適合「同時有刪除與新增」的場景。
2.4 重新索引
沒有找到顯式的重建介面,但也沒必要——重複調用是安全的,只要 uniqueIdentifier 相同就會覆蓋舊資料。
2.5 排名調整
沒有找到干預排序的方法,看起來系統有一套自己的算法在跑。想讓重要內容靠前,目前只能靠提升使用者的實際點擊率。
整體來說 Core Spotlight 的接入門檻很低,兩個介面就足夠跑通。真正的成本在於「哪些內容值得被索引」以及索引時機的把控,而不是 API 本身。