iOS uygulama geliştiricileri, Thread sınır yönlendiriciyi yönetmek için Home API'lerini kullanabilir.
GoogleBorderRouterDevice, iki temel cihaz özelliği kullanılarak uygulanır:
ThreadNetworkCapabilitiesTrait, sınır yönlendirici özelliklerini incelemek için salt okunur özellikler sağlar ve ThreadNetworkManagementTrait, komisyon üyesi için geçici önceden paylaşılan anahtar (ePSKc) kullanarak ağ yaşam döngüsü komutlarını ve kimlik bilgisi paylaşımını yönetir. Yapı düzeyi
internet erişimi politikaları, ThreadNetworkSettingsTrait
özelliği kullanılarak yönetilir.
Herhangi bir özelliği kullanmadan veya özellikleri güncellemeye çalışmadan önce cihazın özellik ve komut desteğini mutlaka kontrol edin. Daha fazla bilgi için iOScihazlarını kontrol etme başlıklı makaleye bakın.
| Home API'leri Cihaz Türü | Özellikler | Swift Örnek Uygulaması | Kullanım Örneği |
|---|---|---|---|
|
Sınır Yönlendirici
|
Zorunlu Özellikler google ThreadNetworkCapabilitiesTrait google ThreadNetworkManagementTrait |
Sınır yönlendirici |
Cihaz hakkında temel bilgileri edinme
BasicInformation
özelliği, bir cihazın satıcı adı, satıcı kimliği, ürün kimliği, ürün adı (model bilgilerini içerir) ve yazılım sürümü gibi bilgileri içerir:
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!
Sınır yönlendirici özelliklerini inceleme
ThreadNetworkCapabilitiesTrait özelliğini kullanarak bir sınır yönlendiricinin salt okunur özelliklerini (ör. ePSKc desteği ve internet erişimi ayar yapılandırması) inceleyebilirsiniz.
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)")
}
}
Thread kimlik bilgisi paylaşımını (ePSKc) yönetme
Thread kimlik bilgisi paylaşımı, Komisyon Üyesi için Geçici Önceden Paylaşılan Anahtar (ePSKc) kullanılarak gerçekleştirilir. ePSKc modu, harici cihazların veya komisyon üyelerinin Thread ağı veri kümesini güvenli bir şekilde elde etmek için kullanabileceği geçici ve güvenli bir geçiş anahtarı oluşturur.
ePSKc modunu etkinleştirme
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 modunu devre dışı bırakma
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 devre dışı bırakma etkinliklerini gözlemleme
Thread sınır yönlendiriciler, bir ePSKc oturumu sona erdiğinde (örneğin, anahtar kullanıldığı, oturumun süresi dolduğu veya oturumun manuel olarak iptal edildiği için) etkinlik yayınlar.
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)")
}
}
Thread ağı üyeliğini yönetme
Etkin operasyonel veri kümesi TLV'lerini sağlayarak bir Thread sınır yönlendiricinin yeni bir Thread ağına katılmasını veya mevcut ağından ayrılmasını sağlayabilirsiniz.
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)")
}
}
Yapı düzeyinde internet erişimini yapılandırma
ThreadNetworkSettings özelliği, Structure öğesine (evi veya binayı temsil eder) eklenen ve güncellenebilen bir özelliktir. Bu politika, geliştiricilerin Thread sınır yönlendiriciler için yapı genelinde internet erişim politikasını yapılandırmasına olanak tanır.
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)")
}
}