iOS 9: Giới thiệu Search APIs (phần 2)

47

Một tập hợp các APIs khác trong iOS 9 hỗ trợ user tìm kiếm nội dung trong app của bạn là Core Spotlight framework. Framework này có một kiểu thiết kế cơ sở dữ liệu và để cho bạn cung cấp nhiều thông tin hơn về nội dung mà bạn muốn nó có thể được tìm kiếm.

Trước khi bạn có thể sử dụng Core Spotlight framework, chúng ta cần kết nối project tới framework này. Trong Project Navigator, chọn project và mở tab Build Phases ở phía trên cùng. Tiếp theo, mở mục Link Binary With Libraries và click vào dấu +. Trong menu xuất hiện, tìm CoreSpotlight và kết nối project tới framework này. Lặp lại những bước này với MobileCoreServices framework.

Tiếp theo, để đảm bảo rằng kết quả tìm kiếm mà ứng dụng của chúng ta cung cấp là từ Core Spotlight, xóa app từ thiết bị thử nghiệm của bạn hoặc iOS Simulator và comment các dòng sau trong class DetailViewController:

Cuối cùng, mở file MasterViewController.swift và thêm vào các dòng sau trước khi định nghĩa structure Show:

Tiếp theo, thêm các đoạn code sau vào viewDidLoad của class MasterViewController:

Trước khi kiểm ta đoạn code này, hãy phân tích từng bước trong vòng lặp for.

  1. Tạo một đối tượng CSSearchableItemAttributeSet, truyền 1 item cho tham số content type. Nếu kết quả tìm kiếm liên kết tới một tấm hình, cho ví dụ, bạn sẽ truyền kUTTypeImage.
  2. Bạn gán cho thuộc tính title của attribute set với giá trị là name của show. Cũng giống như NSUserActivity, title này là cái sẽ được xuất hiện trên cùng của kết quả tìm kiếm.
  3. Tiếp theo, bạn khởi tạo một chuỗi mô tả và gán giá trị này cho thuộc tính contentDescription của attribute set. Chuỗi này sẽ được hiển thị phía dưới tiêu đề kết quả trong Spotlight.
  4. Bạn khởi tạo một mảng chứa các từ khoá kết quả tìm kiếm giống như bạn đã làm với NSUserActivity.
  5. Cuối cùng, bạn khởi tạo một CSSearchableItem với 1 unique item identifier, unique domain identifier để nhóm các items với nhau và 1 attribute set. Không như NSUserActivity, cái mà trả về user activity từ kết quả tìm kiếm, unique identifiers bạn sử dụng cho CSSearchableItem là những thông tin duy nhất mà bạn nhận từ hệ thống khi kết quả tìm kiếm của bạn được chọn từ user. Bạn cần sử dụng những identifiers này để khôi phục app của bạn về trạng thái chính xác nhất.

Mỗi lần bạn khởi tạo 1 CSSearchableItem cho các chương trình TV, bạn chỉ mục chúng sử dụng method indexSearchableItems(_:completionHandler:)  trong đối tượng CSSearchableIndex mặc định.

Build và run app, tất cả những chương trình sẽ được ghi vào mục lục bởi Spotlight. Điều hướng tới khung search và tìm kiếm thử 1 chương trình nào đó.

Kết quả tìm kiếm từ Core Spotlight được xử lý bằng những phương pháp tương tự như NSUserActivity, nhưng tiến trình này hơi khác nhau. Khi 1 CSSearchableItem được chọn từ kết quả tìm kiếm, hệ thống sẽ tạo 1 đối tượng NSUserActivity cho bạn mà chứa unique identifier của item đã chọn.

Trong hàm application(_:continueUserActivity:restorationHandler:) của appdelegate, bạn có thể sử dụng cách sau để nhận thông tin bạn cần từ kết quả tìm kiếm từ Core Spotlight:

Một cách tốt khi chỉ mục nội dung từ app của bạn với Core Spotlight framework là xoá các items khi chúng không còn cần thiết. Class CSSearchableIndex cung cấp 3 methods để xoá các items được tìm kiếm:

  • deleteAllSearchableItemsWithCompletionHandler(_:)
  • deleteSearchableItemsWithDomainIdentifiers(_:completionHandler:)
  • deleteSearchableItemsWithIdentifiers(_:completionHandler:)

Như một ví dụ, thêm đoạn code sau vào cuối hàm viewDidLoad của class MasterViewController:

Build và run app lần nữa. Khi bạn thử tìm bất kỳ 1 chương trình nào, không có kết quả trả về bởi vì chúng đã bị xoá từ mục lục.

Một điều mới được thêm vào class NSUserActivity trong iOS 9 là thuộc tính contentAttributeSet. Thuộc tính này cho phép bạn gán 1 CSSearchableItemAttributeSet, cũng như cái mà bạn đã tạo trước đó. Attribute set này cho phép kết quả tìm kiếm của bạn đối với đối tượng NSUserActivity để hiển thị cùng 1 số chi tiết như kết quả tìm kiếm từ Core Spotlight.

Bắt đầu bằng cách thêm đoạn import sau ở trên cùng file DetailViewController.swift:

Tiếp theo, cập nhật hàm configureView trong class DetailViewController bằng cách sau:

Build và run app, mở vài chương trình lên. Khi bạn tìm kiếm 1 chương trình, bạn sẽ thấy rằng kết quả của bạn, tạo với NSUserActivity, chứa cùng mức độ chi tiết như kết quả tìm kiếm từ Core Spotlight.

Trong bài hướng dẫn này, bạn đã biết được cách làm 1 ứng dụng mà nội dung của nó có thể được truy cập thông qua iOS Spotlight bằng cách sử dụng class NSUserActivity và Core Spotlight framework. Tác giả cũng cho chúng ta thấy cách lập chỉ mục nội dung từ app sử dụng cả 2 APIs này và cách khôi phục trạng thái app khi 1 kết quả tìm kiếm được chọn từ user.

Các API tìm kiếm mới được giới thiệu với iOS 9 rất dễ sử dụng và làm cho nội dung của ứng dụng của bạn dễ dàng hơn để tìm kiếm và dễ tiếp cận hơn cho người dùng của bạn.

Nguồn IDE Academy via code.tutsplus.com