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 tạo home trong ứng dụng. Trong bước này, bạn sẽ tạo một phiên bản singleton của Home cho ngữ cảnh cục bộ.

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

Đây là điểm vào của Home API và cũng bao gồm việc khai báo các đặc điểm và loại thiết bị mà bạn định sử dụng với Device & Structure API và Automation API. Nếu bạn 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, chúng tôi đã gợi ý một số đặc điểm hoặc loại thiết bị phổ biến nhất 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. Nhận 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 getApplicationContext() trong Activity hoặc Service:

   val 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ị Đèn, Ổ cắm, Cảm biến, Công tắc và Máy điều nhiệt, các đặc điểm về sự hiện diện và Trợ lý cho tính năng tự động hoá), phòng 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 đ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))
   

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

3. Khởi tạo HomeConfig bằng cách sử dụng ngữ cảnh coroutine Dispatchers.IO và phiên bản sổ đă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 vào API, bằng cách 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 thực thể singleton của Home bằng cách gói thực thể đó 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ý các đặc điểm 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à kiểu chưa đăng ký có sẵn cho ứng dụng của bạn bằng cách sử dụng quyền nhưng không được bao gồm trong sổ đăng ký gốc sẽ không thể truy cập được bằng API Tự động hóa và chúng 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.