Khởi chạy trang chủ trên Android

Trước khi sử dụng bất kỳ API Home nào cho Android, bạn phải khởi chạy trang chủ trong ứng dụng của mình. Trong bước này, bạn sẽ tạo một thực thể singleton của Home cho ngữ cảnh cục bộ.

Mỗi lần, bạn chỉ có thể kích hoạt một phiên bản của Home.

Đây là điểm truy cập vào Home API, đồng thời liên quan đến việc khai báo những đặc điểm và loại thiết bị mà bạn dự định sử dụng với Device & Structure API và Automation API. Nếu bạn chỉ mới bắt đầu sử dụng hệ sinh thái Google Home và không biết nên đăng ký những đặc điểm hoặc loại thiết bị nào, thì chúng tôi đã đề xuất một số đặc điểm và loại thiết bị phổ biến nhất tại đây trong hướng dẫn này.

Tạo một phiên bản Home

Để bắt đầu, hãy nhập các gói này vào ứng dụng của bạn:

import android.content.Context
import com.google.home.FactoryRegistry
import com.google.home.HomeConfig
import com.google.home.Home

Cách khởi chạy Home API:

  1. Tạo một tham chiếu đến ngữ cảnh Application. Ngữ cảnh này không phụ thuộc vào bất kỳ vòng đời hoạt động nào và sẽ tồn tại miễn là ứng dụng của bạn còn hoạt động. Bạn có thể lấy đối tượng này bằng cách gọi Context.getApplicationContext() hoặc Activity.getApplication().

    val context = Context.getApplicationContext()

  2. Tạo một thực thể FactoryRegistry với tất cả các đặc điểm và loại thiết bị mà bạn dự định sử dụng trong ứng dụng của mình.

    Trong hướng dẫn này, chúng tôi đã đề xuất một số loại phổ biến (các loại thiết bị Light, Plug, Sensor, Switch và Thermostat, các đặc điểm về sự hiện diện và Trợ lý cho tính năng tự động hoá), trong trường hợp bạn không chắc chắn về những gì mình cần. Để tìm hiểu thêm, hãy xem phần Đăng ký các đặc điểm và loại thiết bị.

    val registry = FactoryRegistry(
  traits = listOf(
            AirQuality,
            AreaAttendanceState,
            AreaPresenceState,
            AssistantBroadcast,
            AssistantFulfillment,
            BooleanState,
            ColorControl,
            ExtendedColorControl,
            FlowMeasurement,
            IlluminanceMeasurement,
            LevelControl,
            Notification,
            OccupancySensing,
            OnOff,
            RelativeHumidityMeasurement,
            Switch,
            TemperatureMeasurement,
            Thermostat),
  types = listOf(
            AirQualitySensorDevice,
            ColorDimmerSwitchDevice,
            ColorTemperatureLightDevice,
            ContactSensorDevice,
            DimmableLightDevice,
            DimmablePlugInUnitDevice,
            DimmerSwitchDevice,
            ExtendedColorLightDevice,
            FlowSensorDevice,
            GenericSwitchDevice,
            HumiditySensorDevice,
            LightSensorDevice,
            OccupancySensorDevice,
            OnOffLightDevice,
            OnOffLightSwitchDevice,
            OnOffPluginUnitDevice,
            OnOffSensorDevice,
            SpeakerDevice,
            TemperatureSensorDevice,
            ThermostatDevice))

    Bạn phải nhập câu lệnh cho từng đặc điểm và loại thiết bị riêng lẻ đã đăng ký tại đây (Android Studio sẽ nhắc bạn thêm những câu lệnh này).

  3. Tạo một HomeConfig bằng cách sử dụng ngữ cảnh coroutine Dispatchers.IO và phiên bản đăng ký của bạn.

    val homeConfig = HomeConfig(
        coroutineContext = Dispatchers.IO,
        factoryRegistry = registry)

  4. Cuối cùng, hãy tạo phiên bản singleton của Home. Đây là điểm truy cập vào các API, sử dụng ngữ cảnh và HomeConfig.

    val homeManager: HomeClient = Home.getClient(context, homeConfig)

Để tránh lỗi với các phiên không hợp lệ, điều quan trọng là chỉ tạo một phiên bản singleton của Home bằng cách gói phiên bản đó trong một khai báo đối tượng.

Ví dụ: ứng dụng mẫu thực hiện theo cách này:

internal object HomeClientModule {
  @Provides
  @Singleton
  fun provideHomeClient(@ApplicationContext context: Context): HomeClient {
    return Home.getClient(
      context,
      HomeConfig(
        coroutineContext = IODispatcherModule.provideIoDispatcher(),
        factoryRegistry = registry,
      ),
    )
  }
}

Đăng ký trait và loại thiết bị

Lớp FactoryRegistry giúp nhà phát triển tối ưu hoá kích thước nhị phân của ứng dụng bằng cách cho phép họ chỉ rõ những đặc điểm và loại thiết bị mà ứng dụng của họ sử dụng.

Xin lưu ý rằng các quyền và sổ đăng ký gốc được tách rời. Do đó, các đặc điểm và loại chưa đăng ký có sẵn cho ứng dụng của bạn bằng cách sử dụng các quyền nhưng không có trong sổ đăng ký của nhà máy sẽ không thể truy cập được bằng Automation API và cũng không được trả về trong các lệnh gọi phương thức traits() hoặc types() hàng loạt.

Trước
2. Thiết lập OAuth
Tiếp
4. API Quyền