Skip to content

useBlePermissions

useBlePermissions(): readonly [BlePermissionStatus, () => Promise<BlePermissionStatus>]

Defined in: console-sdk/src/react/hooks/useBlePermissions.ts:68

The BLE permission readout plus an idempotent request action (SDK_PLAN.md §3.6.1). Returns a stable tuple [status, request]: status is reactive (re-renders when the permission facet changes; starts 'undetermined', §3.9.1), and request() prompts once through the transport, updating status and resolving the fresh readout for imperative callers. request() is idempotent and never rejects. Throws OutsideProviderError when no <ConsoleProvider> is above the caller.

readonly [BlePermissionStatus, () => Promise<BlePermissionStatus>]

readonly [BlePermissionStatus, () => Promise<BlePermissionStatus>].

const [permissions, requestPermissions] = useBlePermissions();
if (permissions.status === 'undetermined')
return <Button title="Enable" onPress={requestPermissions} />;