অ্যান্ড্রয়েডে হোম শুরু করুন

অ্যান্ড্রয়েডের জন্য যেকোনো হোম এপিআই ব্যবহার করার আগে, আপনার অ্যাপে হোমটি ইনিশিয়ালাইজ করতে হবে। এই ধাপে, আপনি স্থানীয় প্রসঙ্গের জন্য Home একটি সিঙ্গেলটন ইনস্ট্যান্স তৈরি করবেন।

একবারে Home শুধুমাত্র একটি ইনস্ট্যান্স সক্রিয় থাকা উচিত।

এটি হল হোম এপিআই-এর প্রবেশ বিন্দু এবং ডিভাইস ও স্ট্রাকচার এবং অটোমেশন এপিআই-এর সাথে আপনি কোন বৈশিষ্ট্য এবং ডিভাইসের ধরণগুলি ব্যবহার করতে চান তা ঘোষণা করাও এতে অন্তর্ভুক্ত। আপনি যদি সবেমাত্র গুগল হোম ইকোসিস্টেম দিয়ে শুরু করছেন এবং কোন বৈশিষ্ট্য বা ডিভাইসের ধরণগুলি নিবন্ধন করবেন তা নিশ্চিত না হন, তাহলে আমরা এই নির্দেশিকায় সবচেয়ে সাধারণ কিছু পরামর্শ দিয়েছি।

একটি হোম ইনস্ট্যান্স তৈরি করুন

শুরু করতে, আপনার অ্যাপে এই প্যাকেজগুলি আমদানি করুন:

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

হোম এপিআইগুলি আরম্ভ করতে:

1. Application প্রসঙ্গের একটি রেফারেন্স পান। এই প্রসঙ্গের কোনও কার্যকলাপ জীবনচক্রের উপর নির্ভর করে না এবং আপনার অ্যাপ্লিকেশনটি যতক্ষণ জীবিত থাকবে ততক্ষণ এটি কার্যকর থাকবে। আপনি একটি Activity বা Service মধ্যে getApplicationContext() কল করে এটি পেতে পারেন:

   val context = getApplicationContext()
   

2. আপনার অ্যাপে ব্যবহার করার জন্য আপনার পছন্দের সমস্ত বৈশিষ্ট্য এবং ডিভাইসের ধরণ সহ একটি FactoryRegistry ইনস্ট্যান্স তৈরি করুন।

   এই নির্দেশিকার জন্য, আমরা কিছু সাধারণ (আলো, প্লাগ, সেন্সর, সুইচ এবং থার্মোস্ট্যাট ডিভাইসের ধরণ, অটোমেশনের জন্য উপস্থিতি এবং সহকারী বৈশিষ্ট্য) পরামর্শ দিয়েছি, যদি আপনি নিশ্চিত না হন যে আপনার কী প্রয়োজন। আরও জানতে, বৈশিষ্ট্য এবং ডিভাইসের ধরণের নিবন্ধন দেখুন।

   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))
   

   এখানে নিবন্ধিত প্রতিটি স্বতন্ত্র বৈশিষ্ট্য এবং ডিভাইসের ধরণের জন্য আমদানি বিবৃতি প্রয়োজন ( Android Studio আপনাকে এগুলি যোগ করার জন্য অনুরোধ করবে)।

3. Dispatchers.IO coroutine প্রসঙ্গ এবং আপনার রেজিস্ট্রি ইনস্ট্যান্স ব্যবহার করে একটি HomeConfig ইন্সট্যান্টিয়েট করুন।

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

4. অবশেষে, context এবং HomeConfig ব্যবহার করে Home এর singleton ইনস্ট্যান্স তৈরি করুন, যা API গুলির এন্ট্রি পয়েন্ট।

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

অবৈধ সেশনের ত্রুটি এড়াতে, এটি গুরুত্বপূর্ণ যে শুধুমাত্র একটি সিঙ্গেলটন Home ইনস্ট্যান্স তৈরি করা হয় , এটি একটি অবজেক্ট ডিক্লেয়ারেশনে মোড়ানো হয়।

উদাহরণস্বরূপ, নমুনা অ্যাপ এটি এভাবে করে:

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

বৈশিষ্ট্য এবং ডিভাইসের প্রকারের নিবন্ধন

FactoryRegistry ক্লাস ডেভেলপারদের তাদের অ্যাপের বাইনারি আকার অপ্টিমাইজ করতে সাহায্য করে, যাতে তারা স্পষ্টভাবে নির্দেশ করতে পারে যে তাদের অ্যাপ কোন বৈশিষ্ট্য এবং ডিভাইসের ধরণ ব্যবহার করছে।

মনে রাখবেন যে অনুমতি এবং ফ্যাক্টরি রেজিস্ট্রি আলাদা করা হয়েছে। অতএব, অনিবন্ধিত বৈশিষ্ট্য এবং প্রকারগুলি যা আপনার অ্যাপে অনুমতি ব্যবহার করে উপলব্ধ কিন্তু ফ্যাক্টরি রেজিস্ট্রিতে অন্তর্ভুক্ত নয়, অটোমেশন API ব্যবহার করে অ্যাক্সেসযোগ্য নয় এবং সেগুলি বাল্ক traits() বা types() পদ্ধতি কলগুলিতে ফেরত দেওয়া হয় না।