Nhà phát triển ứng dụng iOS có thể dùng Home API để quản lý bộ định tuyến biên sử dụng giao thức Thread.
GoogleBorderRouterDevice được triển khai bằng cách sử dụng hai đặc điểm chính của thiết bị:
ThreadNetworkCapabilitiesTrait (cung cấp các thuộc tính chỉ có thể đọc để kiểm tra các tính năng của bộ định tuyến biên) và
ThreadNetworkManagementTrait (xử lý các lệnh vòng đời mạng và chia sẻ thông tin đăng nhập
bằng Khoá được chia sẻ trước tạm thời cho người quản lý (ePSKc)). Các chính sách truy cập Internet ở cấp cấu trúc
được quản lý bằng cách sử dụng
ThreadNetworkSettingsTrait
đặc điểm.
Luôn kiểm tra xem thiết bị có hỗ trợ thuộc tính và lệnh hay không trước khi sử dụng bất kỳ tính năng nào hoặc cố gắng cập nhật thuộc tính. Hãy xem bài viết Kiểm soát thiết bị trên iOS để biết thêm thông tin.
| Loại thiết bị Home API | Đặc điểm tính cách | Ứng dụng mẫu Swift | Trường hợp sử dụng |
|---|---|---|---|
|
Bộ định tuyến biên
|
Đặc điểm tính cách bắt buộc google ThreadNetworkCapabilitiesTrait google ThreadNetworkManagementTrait |
Bộ định tuyến biên |
Xem thông tin cơ bản về thiết bị
Đặc điểm tính cách BasicInformation
bao gồm các thông tin như tên nhà cung cấp, mã nhận dạng nhà cung cấp, mã nhận dạng sản phẩm,
tên sản phẩm (bao gồm thông tin về kiểu máy) và phiên bản phần mềm của thiết bị:
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!
Kiểm tra các chức năng của bộ định tuyến biên
Bạn có thể kiểm tra các chức năng chỉ có thể đọc của bộ định tuyến biên (chẳng hạn như hỗ trợ ePSKc và cấu hình chế độ cài đặt Quyền truy cập Internet) bằng cách sử dụng đặc điểm tính cách ThreadNetworkCapabilitiesTrait.
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)")
}
}
Quản lý việc chia sẻ thông tin đăng nhập mạng Thread (ePSKc)
Việc chia sẻ thông tin đăng nhập mạng Thread được thực hiện bằng cách sử dụng Khoá được chia sẻ trước tạm thời cho người quản lý (ePSKc). Chế độ ePSKc tạo một khoá tạm thời và an toàn mà các thiết bị hoặc người quản lý bên ngoài có thể dùng để lấy tập dữ liệu mạng Thread một cách an toàn.
Kích hoạt chế độ 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
}
}
Tắt chế độ 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)")
}
}
Quan sát các sự kiện tắt ePSKc
Bộ định tuyến biên sử dụng giao thức Thread phát ra các sự kiện khi phiên ePSKc kết thúc (ví dụ: do khoá đã được sử dụng, phiên đã hết hạn hoặc bị huỷ theo cách thủ công).
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)")
}
}
Quản lý tư cách thành viên mạng Thread
Bạn có thể yêu cầu bộ định tuyến biên sử dụng giao thức Thread tham gia mạng Thread mới bằng cách cung cấp các TLV Tập dữ liệu hoạt động hiện tại hoặc yêu cầu bộ định tuyến này rời khỏi mạng hiện tại.
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)")
}
}
Định cấu hình quyền truy cập Internet ở cấp cấu trúc
Đặc điểm tính cách ThreadNetworkSettings là một đặc điểm tính cách có thể cập nhật được đính kèm với Structure (đại diện cho một ngôi nhà hoặc toà nhà). Đặc điểm này cho phép nhà phát triển định cấu hình chính sách truy cập Internet trên toàn cấu trúc cho bộ định tuyến biên sử dụng giao thức Thread.
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)")
}
}