iOS অ্যাপ ডেভেলপাররা হোম এপিআই ব্যবহার করে একটি থ্রেড বর্ডার রাউটার পরিচালনা করতে পারেন।
GoogleBorderRouterDevice টি দুটি প্রধান ডিভাইস ট্রেইট ব্যবহার করে বাস্তবায়িত হয়: ThreadNetworkCapabilitiesTrait , যা বর্ডার রাউটারের বৈশিষ্ট্যগুলো পরীক্ষা করার জন্য রিড-অনলি অ্যাট্রিবিউট প্রদান করে, এবং ThreadNetworkManagementTrait , যা কমিশনারের জন্য একটি Ephemeral Pre-Shared Key (ePSKc) ব্যবহার করে নেটওয়ার্ক লাইফসাইকেল কমান্ড এবং ক্রেডেনশিয়াল শেয়ারিং পরিচালনা করে। স্ট্রাকচার-লেভেলের ইন্টারনেট অ্যাক্সেস পলিসিগুলো ThreadNetworkSettingsTrait ট্রেইট ব্যবহার করে পরিচালিত হয়।
যেকোনো বৈশিষ্ট্য ব্যবহার করার বা অ্যাট্রিবিউট আপডেট করার চেষ্টা করার আগে, ডিভাইসটির অ্যাট্রিবিউট এবং কমান্ড সমর্থনের বিষয়টি সর্বদা যাচাই করে নিন। ডিভাইস নিয়ন্ত্রণ দেখুন।iOS আরও তথ্যের জন্য।
| হোম এপিআই ডিভাইসের ধরন | বৈশিষ্ট্য | সুইফট নমুনা অ্যাপ | ব্যবহারের ক্ষেত্র |
|---|---|---|---|
বর্ডার রাউটার | প্রয়োজনীয় বৈশিষ্ট্য গুগল থ্রেডনেটওয়ার্কক্যাপাবিলিটিসট্রেট গুগল থ্রেডনেটওয়ার্কম্যানেজমেন্টট্রেট | সীমান্ত রাউটার |
একটি ডিভাইস সম্পর্কে প্রাথমিক তথ্য জানুন
BasicInformation ট্রেইটটিতে একটি ডিভাইসের জন্য ভেন্ডরের নাম, ভেন্ডর আইডি, প্রোডাক্ট আইডি, প্রোডাক্টের নাম (মডেলের তথ্য সহ), এবং সফটওয়্যার ভার্সনের মতো তথ্য অন্তর্ভুক্ত থাকে:
let vendorName = basicInfoTrait.attributes.vendorName! let vendorID = basicInfoTrait.attributes.vendorID! let productID = basicInfoTrait.attributes.productID! let productName = basicInfoTrait.attributes.productName! let softwareVersion = basicInfoTrait.attributes.softwareVersion!
বর্ডার রাউটারের সক্ষমতা পরীক্ষা করুন
আপনি ThreadNetworkCapabilitiesTrait ট্রেইটটি ব্যবহার করে একটি বর্ডার রাউটারের রিড-অনলি সক্ষমতা (যেমন ePSKc সাপোর্ট এবং ইন্টারনেট অ্যাক্সেস সেটিং কনফিগারেশন) পরীক্ষা করতে পারেন।
func checkBorderRouterCapabilities(device: HomeDevice) async {
// Filter for GoogleBorderRouterDevice device type
guard let gtbrDevice = device.type(Google.GoogleBorderRouterDevice.self) else {
print("Device is not a Google border router.")
return
}
// Retrieve the ThreadNetworkCapabilitiesTrait
guard let capabilitiesTrait = gtbrDevice.traits(Google.ThreadNetworkCapabilitiesTrait.self) else {
print("ThreadNetworkCapabilitiesTrait not found on device.")
return
}
do {
let isEpskcSupported = try await capabilitiesTrait.epskcSupported.read()
let internetAccessOption = try await capabilitiesTrait.internetAccessOption.read()
let isIasSupported = internetAccessOption != .none
print("ePSKc Supported: \(isEpskcSupported)")
print("Internet Access Setting Supported: \(isIasSupported)")
} catch {
print("Failed to read capabilities: \(error)")
}
}
থ্রেড ক্রেডেনশিয়াল শেয়ারিং পরিচালনা করুন (ePSKc)
কমিশনারের জন্য একটি ক্ষণস্থায়ী পূর্ব-শেয়ারকৃত কী (ePSKc) ব্যবহার করে থ্রেড ক্রেডেনশিয়াল শেয়ারিং সম্পন্ন করা হয়। ePSKc মোড একটি অস্থায়ী, সুরক্ষিত পাসকী তৈরি করে যা বাহ্যিক ডিভাইস বা কমিশনাররা থ্রেড নেটওয়ার্ক ডেটাসেট নিরাপদে পেতে ব্যবহার করতে পারে।
ePSKc মোড সক্রিয় করুন
func startEpskcSession(device: HomeDevice, durationSeconds: Int16) async -> Google.ThreadNetworkManagementTrait.ActivateEpskcModeResponse? {
guard let gtbrDevice = device.type(Google.GoogleBorderRouterDevice.self),
let mgmtTrait = gtbrDevice.traits(Google.ThreadNetworkManagementTrait.self) else {
print("ThreadNetworkManagementTrait not found.")
return nil
}
do {
var request = Google.ThreadNetworkManagementTrait.ActivateEpskcModeRequest()
request.requestedDurationSeconds = durationSeconds
let response = try await mgmtTrait.activateEpskcMode(request)
print("ePSKc Session Activated!")
print("Status: \(response.status)")
print("Ephemeral PSKc: \(response.epskc)")
print("Valid Duration (s): \(response.validDurationSeconds)")
return response
} catch {
print("Failed to activate ePSKc mode: \(error)")
return nil
}
}
ePSKc মোড নিষ্ক্রিয় করুন
func stopEpskcSession(device: HomeDevice) async {
guard let gtbrDevice = device.type(Google.GoogleBorderRouterDevice.self),
let mgmtTrait = gtbrDevice.traits(Google.ThreadNetworkManagementTrait.self) else {
return
}
do {
try await mgmtTrait.deactivateEpskcMode(Google.ThreadNetworkManagementTrait.DeactivateEpskcModeRequest())
print("ePSKc mode deactivated.")
} catch {
print("Failed to deactivate ePSKc mode: \(error)")
}
}
ePSKc নিষ্ক্রিয়করণ ঘটনাগুলি পর্যবেক্ষণ করুন
যখন একটি ePSKc সেশন শেষ হয় (উদাহরণস্বরূপ, কী ব্যবহৃত হয়ে গেলে, সেশনের মেয়াদ শেষ হয়ে গেলে, বা এটি ম্যানুয়ালি বাতিল করা হলে), তখন থ্রেড বর্ডার রাউটারগুলো ইভেন্ট নির্গত করে।
func observeEpskcEvents(device: HomeDevice) async {
guard let gtbrDevice = device.type(Google.GoogleBorderRouterDevice.self),
let mgmtTrait = gtbrDevice.traits(Google.ThreadNetworkManagementTrait.self) else {
return
}
do {
for try await event in mgmtTrait.epskcModeDeactivatedEvent.stream() {
print("ePSKc Session Ended. Reason: \(event.reason)")
switch event.reason {
case .keyUsed:
print("Key was successfully used to commission a device.")
case .expired:
print("Session timed out before the key was used.")
case .cancelled:
print("Session was manually cancelled.")
@unknown default:
print("Unknown deactivation reason.")
}
}
} catch {
print("Error streaming ePSKc events: \(error)")
}
}
থ্রেড নেটওয়ার্ক সদস্যপদ পরিচালনা করুন
আপনি সক্রিয় অপারেশনাল ডেটাসেট TLV-গুলো প্রদান করে একটি থ্রেড বর্ডার রাউটারকে নতুন থ্রেড নেটওয়ার্কে যোগ দেওয়ার নির্দেশ দিতে পারেন, অথবা এটিকে তার বর্তমান নেটওয়ার্ক ছেড়ে যাওয়ার নির্দেশ দিতে পারেন।
func joinNetwork(device: HomeDevice, datasetTlvs: Data) async {
guard let gtbrDevice = device.type(Google.GoogleBorderRouterDevice.self),
let mgmtTrait = gtbrDevice.traits(Google.ThreadNetworkManagementTrait.self) else {
return
}
do {
var request = Google.ThreadNetworkManagementTrait.JoinNetworkRequest()
request.operationalDatasetTlvs = datasetTlvs
let response = try await mgmtTrait.joinNetwork(request)
print("Join network command sent. Status: \(response.status)")
} catch {
print("Join network failed: \(error)")
}
}
func leaveNetwork(device: HomeDevice) async {
guard let gtbrDevice = device.type(Google.GoogleBorderRouterDevice.self),
let mgmtTrait = gtbrDevice.traits(Google.ThreadNetworkManagementTrait.self) else {
return
}
do {
try await mgmtTrait.leaveNetwork(Google.ThreadNetworkManagementTrait.LeaveNetworkRequest())
print("Leave network command sent successfully.")
} catch {
print("Leave network failed: \(error)")
}
}
কাঠামো-স্তরের ইন্টারনেট অ্যাক্সেস কনফিগার করুন
ThreadNetworkSettings ট্রেইটটি একটি আপডেটেবল ট্রেইট যা একটি Structure (যা একটি বাড়ি বা বিল্ডিংয়ের প্রতিনিধিত্ব করে) সাথে সংযুক্ত থাকে। এটি ডেভেলপারদের থ্রেড বর্ডার রাউটারগুলোর জন্য স্ট্রাকচার-ব্যাপী ইন্টারনেট অ্যাক্সেস পলিসি কনফিগার করার সুযোগ দেয়।
func updateStructureInternetAccess(structure: Structure, enableInternetAccess: Bool) async {
guard let settingsTrait = structure.traits(Google.ThreadNetworkSettingsTrait.self) else {
print("ThreadNetworkSettingsTrait not found on structure.")
return
}
let option: Google.ThreadNetworkSettingsTrait.InternetAccessOption = enableInternetAccess ? .internetAccessOptionAll : .internetAccessOptionNone
do {
try await settingsTrait.update { mutator in
mutator.internetAccessOption = option
}
print("Successfully updated Thread internet access policy.")
} catch {
print("Failed to update Thread internet access policy: \(error)")
}
}