Trang này được dịch bởi Cloud Translation API.

Tạo ứng dụng mẫu iOS
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Ứng dụng iOS mẫu này sử dụng các API Google Home. Hãy sử dụng hướng dẫn này để tạo và chạy ứng dụng lần đầu tiên.

Điều kiện tiên quyết

Đảm bảo bạn đáp ứng các yêu cầu tối thiểu để sử dụng API Home cho iOS.

Để tạo và cài đặt ứng dụng mẫu, bạn cần có máy tính đã cài đặt Xcode phiên bản 15.3 trở lên.

Tải Xcode xuống

Để kiểm thử ứng dụng, bạn cần:

Một Tài khoản Google được đăng ký trong EAP của API Home đóng vai trò là tài khoản thử nghiệm.
Một Apple ID đã đăng ký tham gia Chương trình dành cho nhà phát triển của Apple để tạo tệp cấu hình thiết bị thực. Nếu bạn chưa tạo, việc đăng ký sẽ tính thêm phí và có thể mất đến 48 giờ để hoàn tất.
Thiết bị iOS (không phải trình mô phỏng) chạy iOS 16.4 trở lên được thiết lập bằng tài khoản thử nghiệm.
Mạng Wi-Fi.
Trung tâm Google hỗ trợ API Nhà.
Bộ định tuyến biên Thread nếu thiết bị của bạn yêu cầu Thread và trung tâm của bạn không có chức năng đó.
Ít nhất một loại thiết bị được hỗ trợ.

Để phát triển, bạn cần có máy Mac đáp ứng các yêu cầu sau:

macOS Sonoma trở lên
Xcode 15.3 trở lên

Tạo tệp cấu hình triển khai của Apple

Trước tiên, ứng dụng phải bật tính năng Chứng thực ứng dụng. Do đó, bạn không thể triển khai ứng dụng này cho các thiết bị trình mô phỏng. Để làm việc này, bạn cần tạo một hồ sơ cấp phép có quyền Chứng thực ứng dụng.

Thứ hai, bạn phải bật Nhóm ứng dụng để giao tiếp giữa ứng dụng và MatterExtension. Để làm được điều này, bạn cần đăng ký giá trị nhận dạng nhóm ứng dụng.

Để biết thêm thông tin, hãy xem phần Tạo hồ sơ cấp phép phát triển của Apple về hồ sơ cấp phép.

Sau đây là các bước tối thiểu cần thiết để triển khai ứng dụng:

Tạo giá trị nhận dạng nhóm ứng dụng để ứng dụng của bạn giao tiếp với MatterExtension.
1. Đăng nhập vào Cổng thông tin dành cho nhà phát triển của Apple.
2. Thêm mã nhận dạng nhóm ứng dụng. Ví dụ: bạn có thể định dạng thuộc tính này là group.com.company.commissioning.
Đăng ký thiết bị thử nghiệm vào tài khoản nhà phát triển.
Tạo hồ sơ cho mục tiêu ứng dụng.
1. Quyết định giá trị nhận dạng gói ứng dụng cho ứng dụng của bạn. Giá trị nhận dạng phải là duy nhất và mang tính mô tả. Ví dụ: bạn có thể định dạng thuộc tính này là com.company.HomeApiSample. Giá trị nhận dạng này sẽ được sử dụng trong phần còn lại của phần này.
2. Đăng ký Mã ứng dụng. Khi được nhắc, hãy thêm chức năng Chứng thực ứng dụng và Nhóm ứng dụng.
3. Chỉnh sửa Mã ứng dụng mới tạo và định cấu hình chức năng Nhóm ứng dụng để thêm giá trị nhận dạng nhóm ứng dụng đã đăng ký.
4. Tạo hồ sơ cấp phép phát triển cho quá trình phát triển ứng dụng. Liên kết mã này với mã ứng dụng mới tạo và các thiết bị thử nghiệm đã chọn. Đảm bảo bạn có chứng chỉ nhà phát triển để ký ứng dụng.
  - Nếu bạn chưa tạo, hãy xem phần Tạo chứng chỉ mã nhận dạng nhà phát triển để biết hướng dẫn.
Tạo hồ sơ cho mục tiêu MatterExtension.
1. Quyết định giá trị nhận dạng gói ứng dụng cho MatterExtension. Giá trị nhận dạng phải được kế thừa từ giá trị nhận dạng ứng dụng. Ví dụ: tệp này có thể được định dạng là com.company.HomeApiSample.MatterExtension.
2. Đăng ký Mã ứng dụng. Khi được nhắc, hãy thêm chức năng Nhóm ứng dụng.
3. Chỉnh sửa mã ứng dụng mới tạo và định cấu hình chức năng Nhóm ứng dụng để thêm giá trị nhận dạng nhóm ứng dụng đã đăng ký được tạo ở các bước trước.
4. Tạo hồ sơ cấp phép phát triển cho MatterExtension.

Tạo mã ứng dụng khách OAuth và bật API Home

Ứng dụng của bạn cần có mã ứng dụng khách OAuth để tự xác định với phần phụ trợ xác thực của Google. Đối với iOS và ứng dụng, bạn phải định cấu hình loại ứng dụng mã ứng dụng khách OAuth là iOS. Ứng dụng cũng sẽ thực hiện các lệnh gọi đến API Home. Để bật chức năng này, bạn phải bật API trong dự án Google Cloud.

Tạo mã ứng dụng khách OAuth

Trong Google Cloud Console, hãy chuyển đến trang tổng quan về bộ chọn dự án rồi chọn dự án mà bạn muốn sử dụng để tạo thông tin xác thực OAuth.
Chuyển đến trang API và Dịch vụ bằng cách nhấp vào nút trình đơn ở góc trên cùng bên trái > Xem tất cả sản phẩm > API và Dịch vụ.
Trong trình đơn điều hướng, hãy nhấp vào Thông tin xác thực.
Nếu bạn chưa định cấu hình màn hình xin phép cho dự án Google Cloud này, thì nút Định cấu hình màn hình xin phép sẽ xuất hiện. Trong trường hợp đó, hãy định cấu hình màn hình yêu cầu đồng ý bằng quy trình sau. Nếu màn hình đồng ý OAuth đã được định cấu hình và trạng thái phát hành là Thử nghiệm, hãy đảm bảo rằng các tài khoản thử nghiệm mà bạn sẽ sử dụng được thêm vào nhóm Người dùng thử nghiệm. Nếu không, hãy chuyển sang bước tiếp theo.
1. Tuỳ thuộc vào trường hợp sử dụng, hãy chọn Nội bộ hoặc Ngoại bộ, sau đó nhấp vào Tạo. Ngăn Màn hình xin phép bằng OAuth sẽ xuất hiện.
2. Nhập thông tin trên Trang thông tin ứng dụng theo hướng dẫn trên màn hình, sau đó nhấp vào Lưu và tiếp tục. Ngăn Scopes (Phạm vi) sẽ hiển thị.
3. Bạn không cần thêm phạm vi nào, vì vậy, hãy nhấp vào Lưu và tiếp tục. Ngăn Người dùng thử nghiệm sẽ hiển thị.
4. Nếu đã chọn tạo màn hình đồng ý nội bộ, bạn phải thêm người dùng để kiểm thử quyền truy cập vào ứng dụng. Nhấp vào Thêm người dùng. Ngăn Thêm người dùng sẽ xuất hiện. Người dùng thử nghiệm có đặc quyền cấp quyền trong ứng dụng của bạn. Trong trường trống, hãy thêm một hoặc nhiều địa chỉ email Tài khoản Google, sau đó nhấp vào Thêm.
5. Nhấp vào Lưu và tiếp tục. Ngăn Summary (Tóm tắt) sẽ hiển thị.
6. Xem lại thông tin trên màn hình xin phép bằng OAuth, sau đó nhấp vào Quay lại trang tổng quan.
Trên bảng trình đơn bên trái, hãy nhấp vào Thông tin xác thực để tạo mã ứng dụng khách OAuth.
1. Nhấp vào nút CREATE CREDENTIALS (TẠO THÔNG TIN XÁC THỰC) rồi chọn OAuth client ID (Mã ứng dụng khách OAuth).
  1. Trong phần loại ứng dụng, hãy chọn iOS.
2. Nhập Mã gói bằng giá trị nhận dạng ứng dụng và Mã nhóm của nhà phát triển Apple. Các trường khác là không bắt buộc và có thể để trống.
3. Nhấp vào CREATE (TẠO) rồi ghi lại Client ID (Mã ứng dụng) hoặc DOWNLOAD PLIST (TẢI Tệp PLIST XUỐNG). Mã này sẽ được dùng sau để bật chức năng luồng quyền. Để biết thêm thông tin, hãy xem phần Tạo thông tin xác thực uỷ quyền.

Bật API Home

Cho phép truy cập vào API Trang chủ.

Trong thẻ API và dịch vụ, hãy nhấp vào API và dịch vụ đã bật.
Nhấp vào BẬT API VÀ DỊCH VỤ ở đầu trang.
Tìm và chọn biểu tượng HOME API.
Trên trang chi tiết về Home API, hãy nhấp vào BẬT.

Tải mã nguồn xuống

Bạn có thể xem mã nguồn cho ứng dụng mẫu trên GitHub.

Chuyển đến vị trí bạn muốn lưu dự án, sau đó nhân bản dự án:

git clone https://github.com/google-home/google-home-api-sample-app-ios.git

Để tải dự án trên Xcode, hãy nhấp vào File (Tệp) > Open (Mở) rồi chọn GoogleHomeAPISampleIOS.xcodeproj ở thư mục gốc của kho lưu trữ được nhân bản.

Thiết lập SDK

Dự án ứng dụng mẫu cần thêm một số thông tin để tạo. Việc này bao gồm việc thêm các tệp Khung SDK trên máy, điền thông tin mã nhận dạng tài khoản nhà phát triển và điền mã ứng dụng OAuth.