# Full device consent dialog
Before a session is upgraded to [full device](https://docs.cobrowse.io/sdk-features/full-device-capabilities), some platforms require a consent from the user. Here is how to customize these consent prompts where possible:
{% tabs %}
{% tab title="Web" %}
**Customizing the full device UI on Web**
```javascript
CobrowseIO.confirmFullDevice = function() {
return new Promise(function(resolve, reject) {
// your logic here
//
// call CobrowseIO.currentSession.fullDevice()
// to get current full device state
//
// you must show a button or UI as part of the DOM
// for the user to click before resolving the promise
//
// call resolve(true) to start full device, or reject()
// to turn off full device
});
}
```
If your custom confirmation prompt is not working in some browsers, please ensure you resolve the promise in response to a user action, such as a button click. This is required by both Safari and Firefox browsers when calling the browser's getDisplayMedia() API, which is used for full device screen share on Web. The call to getDisplayMedia() must be made from code which is running in response to a user action, such as in an event handler.
{% endtab %}
{% tab title="iOS" %}
To override the the full device consent prompt, you should implement the `cobrowseHandleFullDeviceRequest:` method of `CobrowseIODelegate`.
When you override this method you are responsible for presenting a `RPSystemBroadcastPickerView` to the user. See the [Apple docs ](https://developer.apple.com/documentation/replaykit/rpsystembroadcastpickerview?language=objc)for further information on customizing this required view. This view is required by the iOS system in order to launch the broadcast extension.
```objectivec
-(void) cobrowseHandleFullDeviceRequest:(CBIOSession*) session {
// You must show a RPSystemBroadcastPickerView which is provided by the iOS platform.
// Call [session setFullDevice:kCBIOFullDeviceStateRejected callback:nil] if the user
// dismisses the prompt without allowing the full device screen share.
}
```
{% endtab %}
{% tab title="Android" %}
{% hint style="info" %}
**Note:** you cannot replace the system prompt for switching to full device mode. This methods allows you to add logic before the system prompt is shown, or cancel the prompt entirely.
{% endhint %}
To override the the default remote control consent prompt, you should implement the `CobrowseIO.FullDeviceRequestDelegate` interface on your `CobrowseIO.Delegate`.
```java
@Override
public void handleFullDeviceRequest(@NonNull Activity activity, @NonNull Session session) {
// show your own UI here
// call session.setFullDevice(Session.FullDeviceState.On, null) to accept
// or session.setFullDevice(Session.FullDeviceState.Rejected, null) to reject
session.setFullDevice(Session.FullDeviceState.On, null);
}
```
{% endtab %}
{% tab title="React Native" %}
{% hint style="info" %}
Please follow the iOS and Android documentation to implement full device capabilities on React Native by following the steps outlined on [Full device screen sharing](https://docs.cobrowse.io/sdk-features/full-device-capabilities/full-device-screen-sharing)
{% endhint %}
To override the full device consent prompt, you should overwrite the `handleFullDeviceRequest` method on the SDK's main API. For most scenarios, setting this as an empty function should be enough.
```javascript
CobrowseIO.handleFullDeviceRequest = (session) => {
// your code
}
```
Whenever a full device request is received, the callback you set above will be called with the current session object and you're expected to handle the prompt within the application. Please check the examples below.
**iOS**
On iOS, you need to present a `RPSystemBroadcastPickerView` to the user. To help achieve this, we expose a Native UI component that you must render in your application, `CBIOBroadcastPickerView`.
{% hint style="info" %}
Please note that **`RPSystemBroadcastPickerView` is an iOS only component and, as a result, the following code will not work on Android**. You must **ensure that this is only included for iOS** through the use of platform specific files or platform conditionals.
{% endhint %}
You can control the size and color of the `RPSystemBroadcastPickerView` as shown below, via the `style` and `buttonColor` props.
```javascript
// FullDevicePrompt.ios.js
import React from 'react'
import {
Text,
View,
Modal,
Button
} from 'react-native'
import CobrowseIO, { CBIOBroadcastPickerView } from 'cobrowse-sdk-react-native'
CobrowseIO.handleFullDeviceRequest = () => {}
export function FullDevicePrompt () {
const session = useSession();
const isVisible = session?.full_device === 'requested'
const reject = () => session?.setFullDevice('off')
return (
Tap the record icon to manage full device screen sharing.
)
}
```
**Android**
On Android, we can't overwrite the system prompt but you can choose to present a prompt that explains what is happening to your users. To do this, you can follow the following example:
```javascript
// FullDevicePrompt.android.js
import React from 'react'
import {
Text,
View,
Modal,
Button
} from 'react-native'
import CobrowseIO, { CBIOBroadcastPickerView } from 'cobrowse-sdk-react-native'
CobrowseIO.handleFullDeviceRequest = () => {}
export function FullDevicePrompt () {
const session = useSession();
const isVisible = session?.full_device === 'requested'
const reject = () => session?.setFullDevice('rejected')
const displaySystemPrompt = () => session?.setFullDevice('on')
return (
An agent has requested to screen share your full device.
If you wish to accept please press "Continue" and "Accept" the
system prompt. Otherwise press "Cancel".
)
}
```
{% hint style="info" %}
Note that you must call `session?.setFullDevice('on')` on your prompt for the require Android prompt to be displayed so the user can accept it.
{% endhint %}
{% endtab %}
{% tab title="macOS" %}
To override the the full device consent prompt, you should implement the `cobrowseHandleFullDeviceRequest:` method of `CobrowseIODelegate`.
```objectivec
-(void) cobrowseHandleFullDeviceRequest:(CBIOSession*) session {
// Call [session setFullDevice:kCBIOFullDeviceStateRejected callback:nil] if the user
// dismisses the prompt without allowing the full device screen share.
// Or [session setFullDevice:kCBIOFullDeviceStateOn callback:nil] to allow the switch
// full device mode.
}
```
{% endtab %}
{% tab title="Flutter" %}
{% hint style="info" %}
Please see the iOS and Android documentation for customizing the full device consent dialog.
{% endhint %}
{% endtab %}
{% tab title=".NET Mobile" %}
{% hint style="info" %}
Please see the iOS and Android documentation for customizing the full device consent dialog.
{% endhint %}
{% endtab %}
{% endtabs %}
Full device by default, use the [user consent dialog](https://docs.cobrowse.io/sdk-features/customize-the-interface/user-consent-dialog).
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.cobrowse.io/sdk-features/customize-the-interface/full-device-consent-dialog.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.