Struct WifiEffects 

pub struct WifiEffects<'a, 'b, S: AppState> { /* private fields */ }

Convenience builder for standard Wi-Fi host capabilities.

Implementations

impl<'a, 'b, S: AppState> WifiEffects<'a, 'b, S>

pub fn availability(self) -> EffectBuilder<'a, 'b, S>

Queries current Wi-Fi adapter and connection availability.

Use this before showing scan or connect controls. The result can include whether the adapter is enabled and which network, if any, is connected.

pub fn request_permission( self, request: WifiPermissionRequest, ) -> EffectBuilder<'a, 'b, S>

Requests Wi-Fi or nearby-network permission from the host.

request.reason should describe the feature that needs network discovery or management. Hosts may map this to Wi-Fi, nearby-device, or location permission prompts depending on platform policy.

pub fn scan_networks(self, request: WifiScanRequest) -> EffectBuilder<'a, 'b, S>

Scans for nearby Wi-Fi networks where the host permits scanning.

request.ssid_prefix narrows results for device-setup flows, include_hidden asks the host to include hidden networks when possible, and timeout_ms bounds the scan.

pub fn connect_network( self, request: WifiConnectRequest, ) -> EffectBuilder<'a, 'b, S>

Requests connection to one Wi-Fi network.

request carries SSID, optional passphrase, security type, and hidden network flag. Hosts may reject connections that require user confirmation, saved network profiles, entitlements, or administrator privileges.

pub fn disconnect_network( self, request: WifiDisconnectRequest, ) -> EffectBuilder<'a, 'b, S>

Requests disconnection from a Wi-Fi network.

request.ssid can limit the operation to a specific network when the host supports that distinction. Some platforms do not allow apps to disconnect global network state.