Skip to content

features/output

useIosOutputExternal()

ts
function useIosOutputExternal(): boolean;

Hook that returns whether the active output is external (iOS only). Updates when the output changes (e.g., AirPods connected/disconnected). Always returns false on Android.

Returns

boolean


onIosOutputExternalChanged

ts
const onIosOutputExternalChanged: NativeUpdatedValue<boolean>;

Subscribes to output state changes (iOS only). Fires when switching between built-in speaker and external outputs. Never fires on Android.

Param

Called with true when active output is external, false otherwise

Returns

Cleanup function to unsubscribe


isIosOutputExternal()

ts
function isIosOutputExternal(): boolean;

Returns whether the active output is external (iOS only). Returns true for AirPlay, Bluetooth, headphones, CarPlay, etc. Returns false when using the device's built-in speaker. Always returns false on Android.

Returns

boolean


openIosOutputPicker()

ts
function openIosOutputPicker(): void;

Opens the system output picker (iOS only). Allows users to select output device (speaker, AirPlay, Bluetooth, etc.). No-op on Android.

Returns

void