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

Ứng dụng mẫu này minh hoạ các chức năng cơ bản của Google Home API 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 phiên bản này có thể không hoạt động đúng cách với Home APIs SDK.

    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ử Home API, 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 mới nhất của Android Studio và đăng nhập bằng tài khoản 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ó thiết bị trung tâm của Google hỗ trợ Home API. Hãy xem bài viết Kết nối trên Android để biết thông tin chi tiết.

  • Có í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 giao thức Thread, thì trung tâm cũng phải là bộ định tuyến biên theo giao thức Thread. Ứng dụng mẫu Android hỗ trợ các loại thiết bị và đặc điểm sau đây:

    • Đèn 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ó màu mở rộng (bật và tắt, độ sáng)
    • Generic Switch
    • Cảm biến phát hiện người trong nhà (nhận biết sự hiện diện)
    • Bật/Tắt đèn (bật và tắt, độ sáng)
    • Công tắc đèn bật/tắt
    • Thiết bị bổ trợ 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 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-android.git

Thiết lập SDK

Home API cho Android trong phiên bản thử nghiệm beta công khai này chưa thuộc các thư viện tiêu chuẩn do Google cung cấp để phát triển. Để phát triển các ứng dụng Android bằng Home API, bạn cần tải xuống và lưu trữ các thư viện cục bộ.

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

Đă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 xuống tất cả các phần phụ thuộc của dự án và hoàn tất bản dựng Gradle.

  3. Kết nối máy tính với điện thoại Android thực tế thông qua cáp USB và bật ADB trong 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 đây, 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 của gói mà bạn muốn thay đổi – nói cách khác, hãy chọn com.example.
    4. Nhấp chuột phải vào gói rồi chọn Refactor (Tái cấu trúc) > Rename... (Đổi tên...) 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 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 đó sẽ tự động tạo một chứng chỉ gỡ lỗi dành cho mục đích 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 mục đích 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 nội dung 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ố hiệu mẫu. Chọn thiết bị của bạn trong danh sách, rồi nhấp vào 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 phần 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 phần Quản lý ứng dụng OAuth / Loại ứng dụng / Ứng dụng gốc / Android trên trang trợ giúp của Bảng điều khiển Google Cloud.

  1. 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 dùng để tạo thông tin đăng nhập OAuth.
  2. Chuyển đến trang API và dịch vụ, rồi nhấp vào 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 xin phép cho dự án này trên Google Cloud, 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 xin phép theo quy trình sau. Nếu không, hãy chuyển sang phần tiếp theo.

    1. Nhấp vào Định cấu hình màn hình đồng ý. Trang màn hình xin phép bằ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 Nội bộ hoặc Bên ngoài, rồi nhấp vào Tạo. Ngăn màn hình xin phép bằng OAuth sẽ xuất hiện.
    3. Nhập thông tin trên trang Thông tin về ứng dụng theo hướng dẫn trên màn hình, rồi nhấp vào 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 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 kiểm thử sẽ xuất hiện.
    5. Nhấp vào Đối tượng rồi nhấp vào nút + THÊM NGƯỜI DÙNG.
    6. Nhập địa chỉ email của người dùng kiểm thử rồi nhấp vào nút LƯU.
    7. Nhấp vào Lưu và tiếp tục. Ngăn Tóm tắt sẽ xuất hiện.
    8. Xem lại thông tin trên màn hình xin phép bằng OAuth, rồi nhấp vào Quay lại trang tổng quan.

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

Thiết lập thông tin đăng nhập OAuth

  1. Đăng ký ứng dụng mẫu cho OAuth 2.0 và tạo thông tin đăng nhập OAuth bằng cách làm theo hướng dẫn trong phần Thiết lập OAuth 2.0.
    1. Cho biết loại ứng dụng là ứ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 phần Thiết lập OAuth 2.0 / Ứng dụng gốc / Android trên trang trợ giúp của Bảng điều khiển Google Cloud. 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 Chạy dự án để chạy ứng dụng mẫu trên thiết bị di động.

Sau khi cài đặt, ứng dụng này 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 Home API).