Ứng dụng mẫu Home API cho Android

Ứng dụng mẫu trình bày các tính năng cơ bản của API Google Home dành cho Android.

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

Để tạo, cài đặt và kiểm thử ứng dụng, bạn cần đáp ứng một số điều kiện tiên quyết:

  • Android Studio phiên bản 2024.2.1 ("Ladybug") trở lên. Xin lưu ý rằng các phiên bản cũ hơn có thể không hoạt động đúng cách với SDK API Home.

    Tải Android Studio xuống

  • Trình gỡ lỗi Android (adb).

    Cài đặt adb.

    Bạn có thể thực hiện việc này bằng Trình quản lý SDK.

Để kiểm thử API Home, bạn cần:

  • Một thiết bị Android chạy Android 10 trở lên được thiết lập bằng Tài khoản Google mà bạn dự định dùng để phát triển. Đảm bảo bạn đã cài đặt phiên bản Android Studio mới nhất và đăng nhập bằng tài khoản nhà phát triển này.
  • Mạng Wi-Fi.
  • Để truy cập và điều khiển các thiết bị Matter, bạn cũng cần có một thiết bị trung tâm của Google hỗ trợ API Home. Hãy xem bài viết Khả năng kết nối trên Android để biết thông tin chi tiết.

  • Ít nhất một thiết bị được hỗ trợ trong nhà. Nếu thiết bị này (hoặc bất kỳ thiết bị nào khác mà bạn muốn kiểm thử) sử dụng Thread, thì thiết bị trung tâm cũng phải là bộ định tuyến biên Thread. Ứng dụng mẫu Android hỗ trợ các loại thiết bị và đặc điểm sau:

    • Đèn có nhiệt độ màu (bật và tắt, độ sáng)
    • Cảm biến tiếp xúc (trạng thái boolean)
    • Đèn có thể điều chỉnh độ sáng (bật và tắt, độ sáng)
    • Đèn có dải màu mở rộng (bật và tắt, độ sáng)
    • Công tắc chung
    • Bộ định tuyến biên của Google
    • Google Máy ảnh
    • Cảm biến phát hiện người trong nhà (nhận biết sự hiện diện)
    • Đèn bật/tắt (bật và tắt, độ sáng)
    • Công tắc đèn bật/tắt
    • Thiết bị bật/tắt (bật và tắt)
    • Cảm biến bật/tắt

Tải mã nguồn xuống

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

Chuyển đến vị trí bạn muốn lưu dự án, sau đó sao chép dự án đó:

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

Thiết lập SDK

API Home dành cho Android trong bản beta mở này chưa thuộc các thư viện tiêu chuẩn mà Google cung cấp cho quá trình phát triển. Để phát triển các ứng dụng Android bằng API Home, bạn cần tải và lưu trữ các thư viện này cục bộ.

Để tải SDK Android API Home xuống, trước tiên, bạn phải đăng nhập vào Nhà phát triển Google Home.

Đăng nhập ngay!

Tạo ứng dụng

  1. Mở Android Studio, sau đó mở thư mục dự án google-home-api-sample-app-android mà bạn đã sao chép vào máy cục bộ.

  2. Trong lần thiết lập đầu tiên, Android Studio có thể mất tối đa 10 phút để tải tất cả các phần phụ thuộc của dự án xuống và hoàn tất quá trình tạo Gradle.

  3. Kết nối máy tính với điện thoại Android thực bằng cáp USB và bật ADB trong các tuỳ chọn cho nhà phát triển. Đảm bảo Android Studio có thể kết nối với điện thoại Android thông qua ADB.

  4. Thay đổi tên gói của Ứng dụng mẫu thành một tên mới chưa được đăng ký trước đó, chẳng hạn như tên dựa trên tên của tổ chức bạn:

    1. Mở dự án.
    2. Mở rộng hệ phân cấp nguồn.
    3. Chọn phần gói mà bạn muốn thay đổi – nói cách khác là com.example.
    4. Nhấp chuột phải vào gói rồi chọn Refactor > Rename... Tái cấu trúc > Đổi tên trình đơn
    5. Nhập tên mới rồi nhấp vào Refactor (Tái cấu trúc).
    6. Chỉnh sửa tệp build.gradle.kts, thay đổi android namespace (không gian tên Android) và applicationId thành tên gói mới.

  5. Sau khi tải xuống tất cả các thư viện bắt buộc và quá trình đồng bộ hoá Gradle hoàn tất, hãy nhấp vào nút Run (Chạy) để tạo và chạy ứng dụng. Khi ứng dụng chạy thành công trên điện thoại, bạn sẽ thấy trang chính của Ứng dụng mẫu.

Tạo chứng chỉ ký

Khi bạn chạy hoặc gỡ lỗi một ứng dụng trong Android Studio, ứng dụng này sẽ tự động tạo một chứng chỉ gỡ lỗi dành cho quá trình phát triển và gỡ lỗi. Hãy xem bài viết Android Studio: Ký bản gỡ lỗi để biết giải thích đầy đủ.

  1. Tạo chứng chỉ ký ứng dụng gỡ lỗi bằng cách chạy ứng dụng trong Android Studio. Khi bạn chạy hoặc gỡ lỗi một ứng dụng trong Android Studio, Android Studio sẽ tự động tạo một chứng chỉ ký ứng dụng dành cho quá trình phát triển và gỡ lỗi. Hãy xem Android Studio: Ký bản gỡ lỗi để biết giải thích đầy đủ.

    Kết nối thiết bị di động với máy cục bộ. Android Studio sẽ liệt kê các thiết bị đã kết nối theo số kiểu. Chọn thiết bị của bạn trong danh sách, sau đó nhấp vào Run project (Chạy dự án). Thao tác này sẽ tạo và cài đặt Ứng dụng mẫu trên thiết bị di động của bạn.

    Để biết hướng dẫn chi tiết hơn, hãy xem bài viết Chạy ứng dụng trên thiết bị phần cứng trên trang web dành cho Nhà phát triển Android.

    Bây giờ, hãy dừng ứng dụng đang chạy.

  2. Lấy dấu vân tay SHA-1 của chứng chỉ gỡ lỗi bằng cách làm theo hướng dẫn chi tiết trong Quản lý ứng dụng OAuth / Loại ứng dụng / Ứng dụng gốc / Android trên trang web Trợ giúp của Google Cloud Console.

  1. Trong Bảng điều khiển Google Cloud, 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 dùng để tạo thông tin xác thực OAuth.
  2. Chuyển đến trang APIs and Services (API và Dịch vụ), rồi nhấp vào Credentials (Thông tin xác thực) trong trình đơn điều hướng.

  3. Nếu bạn chưa định cấu hình màn hình đồng ý cho dự án Google Cloud này, thì nút Configure consent screen (Định cấu hình màn hình đồng ý) sẽ xuất hiện. Trong trường hợp đó, hãy định cấu hình màn hình đồng ý theo quy trình sau. Nếu không, hãy chuyển sang phần tiếp theo.

    1. Nhấp vào Configure consent screen (Định cấu hình màn hình đồng ý). Trang OAuth consent screen (Màn hình đồng ý OAuth) sẽ xuất hiện.
    2. Tuỳ thuộc vào trường hợp sử dụng của bạn, hãy chọn Internal (Nội bộ) hoặc External (Bên ngoài), rồi nhấp vào Create (Tạo). Ngăn OAuth consent screen (Màn hình đồng ý OAuth) sẽ xuất hiện.
    3. Nhập thông tin trên App information page (Trang thông tin ứng dụng) theo hướng dẫn trên màn hình, sau đó nhấp vào Save and continue (Lưu và tiếp tục). Ngăn Scopes (Phạm vi) sẽ xuất hiện.
    4. Bạn không cần thêm bất kỳ phạm vi nào, vì vậy hãy nhấp vào Save and continue (Lưu và tiếp tục). Ngăn Test users (Người dùng thử nghiệm) sẽ xuất hiện.
    5. Nhấp vào Audience (Đối tượng) rồi nhấp vào nút + ADD USERS (+ THÊM NGƯỜI DÙNG).
    6. Nhập địa chỉ email của người dùng thử nghiệm rồi nhấp vào nút SAVE (LƯU).
    7. Nhấp vào Save and continue (Lưu và tiếp tục). Ngăn Summary (Tóm tắt) sẽ xuất hiện.
    8. Xem lại thông tin trên màn hình đồng ý OAuth, sau đó nhấp vào Back to dashboard (Quay lại trang tổng quan).

Hãy xem bài viết Thiết lập màn hình đồng ý OAuth trên trang web Trợ giúp của Google Cloud Console để biết thông tin chi tiết. Hãy nhớ thêm ít nhất một người dùng thử nghiệm trước khi tiếp tục.

Thiết lập thông tin xác thực OAuth

  1. Đăng ký Ứng dụng mẫu cho OAuth 2.0 và tạo thông tin xác thực OAuth bằng cách làm theo hướng dẫn trong bài viết Thiết lập OAuth 2.0.
    1. Cho biết loại ứng dụng là native/Android app (ứng dụng gốc/Android).
    2. Thêm dấu vân tay SHA-1 vào ứng dụng OAuth bằng cách làm theo hướng dẫn trong bài viết Thiết lập OAuth 2.0 / Ứng dụng gốc / Android trên trang web Trợ giúp của Google Cloud Console. Bạn nên tạo khoá SHA-1 từ khoá Android Studio mặc định trong suốt quá trình phát triển.

Chạy ứng dụng

  1. Khi thiết bị di động của bạn được kết nối với máy cục bộ, hãy nhấp lại vào Run project (Chạy dự án) để chạy Ứng dụng mẫu trên thiết bị di động của bạn.

Sau khi cài đặt, ứng dụng sẽ có trên thiết bị di động của bạn dưới dạng Home API Sample App (Ứng dụng mẫu API Home).