A sequence that vends updates to a paired device list, as the list changes.
The `DevicesSequence` produces an asynchronous sequence of
``WAPairedDevice/Devices`` items, providing the latest snapshot of the
paired devices known to your app.
Makes an asynchronous iterator that provides successive device snapshots when the list of paired devices known to the app changes.
- Returns: A new asynchronous iterator vending ``WAPairedDevice/Devices`` elements when changes occur.
Fetches a one-time snapshot of all paired devices that are currently known and accessible to your app.
The ``WAPairedDevice/Devices`` dictionary holds a snapshot of the currently paired devices that are known and accessible to your app.
This method returns an empty dictionary if there are no paired devices known to your app.
The following code is an example of how to use `current()` to return the first `Devices` snapshot in the sequence:
```swift
guard let devices = try await WAPairedDevice.allDevices.current() { return }
```
Don't use this method if you need to monitor for changes to the paired device list, or change app behavior in
response to such changes. Instead, use
```swift
for try await devices in WAPairedDevice.allDevices {
// Process the devices.
}
```
- Returns: A single ``WAPairedDevice/Devices`` element holding a snapshot of the currently paired devices known to the app, or `nil` if the sequence has no more values.
> Throws: An error if the system can't read the sequence, or if the app isn't permitted to access Wi-Fi Aware devices.
- seeAlso: ``WAPairedDevice/allDevices``
- seeAlso: ``WAPairedDevice/allDevices(matching:)``