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

Ứng dụng mẫu này giới thiệu các chức năng cơ bản của API Google Home.

Đ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 SDK API Nhà.

    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 sử dụng để phát triển. Đảm bảo bạn đã cài đặt và đăng nhập bằng tài khoản phát triển này vào phiên bản mới nhất của Android Studio.
  • Mạng Wi-Fi.
  • Trung tâm Google hỗ trợ các API Home.

  • Í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ì trung tâm cũng phải là một 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:

    • Ánh sáng 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)
    • Extended Color Light (bật và tắt, độ sáng)
    • Công tắc chung
    • 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
    • Đơn vị cắm bật/tắt (bật và tắt)
    • Cảm biến bật/tắt

  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 sử dụng để tạo thông tin xác thực 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 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 xin phép bằng cách làm 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, 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.
    3. 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 Phạm vi sẽ hiển thị.
    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 thử nghiệm sẽ hiển thị.
    5. Nếu bạn muốn thêm người dùng để kiểm thử quyền truy cập vào ứng dụng, hãy nhấp vào Thêm người dùng. Ngăn Thêm người dùng sẽ hiển thị. Người dùng thử nghiệm có đặc quyền cấp quyền trong ứng dụng của bạn.
    6. Trong trường trống, hãy thêm một hoặc nhiều địa chỉ email của Tài khoản Google, sau đó nhấp vào Thêm.
    7. Nhấp vào Lưu và tiếp tục. Ngăn Summary (Tóm tắt) sẽ hiển thị.
    8. 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.

Hãy xem bài viết Thiết lập màn hình đồng ý bằng OAuth trên trang web Trợ giúp của Google Cloud Console để biết toàn bộ thông tin chi tiế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

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

Để tải SDK Android Home API 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!

Xây dựng và chạy

  1. Mở Android Studio, sau đó mở thư mục dự án google-home-api-sample-app-android đã được nhân bản sang máy cục bộ.
  2. Trong lần thiết lập đầu tiên, Android Studio có thể mất tới 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 bản dựng Gradle.
    • Nếu bạn gặp lỗi trong bước này, chẳng hạn như Gradle Sync Failed, hãy nhấp vào Thử lại để bắt đầu đồng bộ hoá lại.
  3. Thay đổi tên gói cho ứng dụng mẫu thành một tên mới chưa từng được đăng ký, chẳng hạn như tên dựa trên tên tổ chức của 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 là 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…)
    5. Nhấp vào Tất cả thư mục.
    6. Nhập tên mới rồi nhấp vào Refactor (Tái cấu trúc).
    7. Chỉnh sửa tệp build.gradle.kts, thay đổi android namespace và applicationId thành tên gói mới.
    8. Chỉnh sửa tệp AndroidManifest.xml và thay đổi gói thành tên gói mới bất cứ khi nào tên gói xuất hiện trong tệp.

  4. Tạo khoá OAuth 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 khoá OAuth dành cho việc phát triển và gỡ lỗi. Hãy xem bài viết Android Studio: Ký bản dựng 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 tính cục bộ. Android Studio sẽ liệt kê các thiết bị đã kết nối theo số mẫ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 bản dựng 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.

  5. Lấy vân tay SHA-1 của chứng chỉ OAuth bằng cách làm theo hướng dẫn chi tiết trong phần 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.

  6. Đă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 phần Thiết lập OAuth 2.0.

    1. Cho biết loại ứng dụng, là ứng dụng gốc/ứng dụng Android.
    2. Thêm 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 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.
    3. Thêm người dùng thử nghiệm. Người dùng thử nghiệm có đặc quyền cấp quyền trong ứng dụng mẫu.

  7. Khi thiết bị di động của bạn đã 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.

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 Ứng dụng mẫu API Home.