কী ভ্যালু এপিআই

Key Value API ডিভাইস, রুম এবং অটোমেশন অবজেক্টের জন্য নতুন কাস্টম ডেটা ম্যানেজমেন্ট API প্রদান করে। কাস্টম ডেটার জীবনচক্রটি যে অবজেক্টের সাথে যুক্ত তার জীবনচক্রের সাথে কঠোরভাবে সীমাবদ্ধ। উদাহরণস্বরূপ, একটি রুম অবজেক্টের সাথে যুক্ত কাস্টম ডেটা (যেমন "লুসির রুম") স্বয়ংক্রিয়ভাবে রুম অবজেক্টের সাথে মুছে ফেলা, সরানো বা স্থানান্তরিত হবে (কাঠামো জুড়ে)।

কোটলিন এপিআই পরিবর্তনটি hasCustomAppData ইন্টারফেসের উপর কেন্দ্রীভূত এবং কাস্টম অ্যাপ্লিকেশন ডেটা যে বস্তুর সাথে সম্পর্কিত তার এক্সটেনশন প্রদান করে এবং স্ট্যান্ডার্ড create, read, update, and delete (CRUD) ফাংশন অন্তর্ভুক্ত করে।

ডিভাইসের উদাহরণ

val device = homeClient.devicesWithLogging().findDeviceByName(deviceName)
var response = device.getValue(key)
println("Before: $response")
device.updateValue(key, value)
response = device.getValue(key)
println("After: $response")
device.deleteValue(key)

রুমের উদাহরণ

val room = homeClient.rooms().findRoomByName(roomName)
room.updateValue("nickname", "Lucy's Room")
val response = room.getValue("nickname")
room.deleteValue("nickname")

অটোমেশনের উদাহরণ

val automation = homeClient.automations().findAutomationByName(automationName)
var response = automation.getValue(key)
println("Before: $response")
automation.updateValue(key, value)
response = automation.getValue(key)
println("After: $response")
automation.deleteValue(key)

বিধিনিষেধ

• কীটি অবশ্যই বৈধ UTF-8 অক্ষরের একটি স্ট্রিং হতে হবে, যার সর্বোচ্চ দৈর্ঘ্য ১২৮ হতে পারে। কীটি একটি খালি স্ট্রিং হতে পারে।
• মানটি অবশ্যই বৈধ UTF-8 অক্ষরের একটি স্ট্রিং হতে হবে, যার সর্বোচ্চ দৈর্ঘ্য ১০২৪ হতে পারে। মানটি একটি খালি স্ট্রিং হতে পারে।
• প্রতিটি বস্তুতে ১০টি সারি কী মান জোড়া থাকতে পারে।