RoleManagerCompat

const val ROLE_ASSISTANT = "android.app.role.ASSISTANT": String!

The name of the assistant role.

To qualify for this role, an application needs to either implement android.service.voice.VoiceInteractionService or handle ACTION_ASSIST. The application will be able to access call log and SMS for its functionality.

const val ROLE_BROWSER = "android.app.role.BROWSER": String!

The name of the browser role.

To qualify for this role, an application needs to handle the intent to browse the Internet:

<activity>
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.BROWSABLE" />
        <category android:name="android.intent.category.DEFAULT" />
        <data android:scheme="http" />
    </intent-filter>
</activity>

The application will be able to handle that intent by default.

Apps that hold this role are allowed to start activities in response to notification clicks or notification action clicks when targeting S to give browsers time to adapt. This is temporary and browsers will be subjected to the same trampoline restrictions at some point in future releases. For more details on those restrictions see setContentIntent and Builder.

const val ROLE_CALL_REDIRECTION = "android.app.role.CALL_REDIRECTION": String!

The name of the call redirection role.

To qualify for this role, an application needs to implement android.telecom.CallRedirectionService. The application will be able to re-write the phone number for an outgoing call to place the call through a call redirection service.

const val ROLE_CALL_SCREENING = "android.app.role.CALL_SCREENING": String!

The name of the call screening and caller id role.

To qualify for this role, an application needs to implement android.telecom.CallScreeningService. The application will be able to screen calls and provide call identification. The application will also be able to display over other apps on Android 11 or above.

const val ROLE_DIALER = "android.app.role.DIALER": String!

The name of the dialer role.

To qualify for this role, an application needs to handle the intent to dial, and implement an android.telecom.InCallService if the application targets android.os.Build.VERSION_CODES.TIRAMISU or higher:

<activity>
    <intent-filter>
        <action android:name="android.intent.action.DIAL" />
        <category android:name="android.intent.category.DEFAULT"/>
    </intent-filter>
    <intent-filter>
        <action android:name="android.intent.action.DIAL" />
        <category android:name="android.intent.category.DEFAULT"/>
        <data android:scheme="tel" />
    </intent-filter>
</activity>
<service android:permission="android.permission.BIND_INCALL_SERVICE">
    <meta-data android:name="android.telecom.IN_CALL_SERVICE_UI" android:value="true" />
    <meta-data
        android:name="android.telecom.IN_CALL_SERVICE_CAR_MODE_UI"
        android:value="false" />
    <intent-filter>
        <action android:name="android.telecom.InCallService" />
    </intent-filter>
</service>

The application will be able to handle those intents by default, and gain access to phone, contacts, SMS, microphone and camera.

const val ROLE_EMERGENCY = "android.app.role.EMERGENCY": String!

The name of the emergency role.

You may not be able to request for this role on most devices as it's hidden by default and only for system apps.

To qualify for this role, an application needs to handle the intent for emergency assitance:

<activity>
    <intent-filter>
        <action android:name="android.telephony.action.EMERGENCY_ASSISTANCE" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</activity>

The application will be used for emergency assistance.

const val ROLE_HOME = "android.app.role.HOME": String!

The name of the home role.

To qualify for this role, an application needs to handle the intent for home:

<activity>
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.HOME" />
    </intent-filter>
</activity>

The application will be able to handle that intent by default, and used as the default home app.

const val ROLE_SMS = "android.app.role.SMS": String!

The name of the SMS role.

To qualify for this role, an application needs to declare the following components:

<activity>
    <intent-filter>
        <action android:name="android.intent.action.SENDTO" />
        <category android:name="android.intent.category.DEFAULT" />
        <data android:scheme="smsto" />
    </intent-filter>
</activity>
<service android:permission="android.permission.SEND_RESPOND_VIA_MESSAGE">
    <intent-filter>
        <action android:name="android.intent.action.RESPOND_VIA_MESSAGE" />
        <category android:name="android.intent.category.DEFAULT" />
        <data android:scheme="smsto" />
    </intent-filter>
</service>
<receiver android:permission="android.permission.BROADCAST_SMS">
    <intent-filter>
        <action android:name="android.provider.Telephony.SMS_DELIVER" />
    </intent-filter>
</receiver>
<receiver android:permission="android.permission.BROADCAST_WAP_PUSH">
    <intent-filter>
        <action android:name="android.provider.Telephony.WAP_PUSH_DELIVER" />
        <data android:mimeType="application/vnd.wap.mms-message" />
    </intent-filter>
</receiver>

The application will be able to handle the intent to send SMS by default, and gain access to phone, contacts, SMS, storage, microphone and camera.

const val ROLE_SYSTEM_GALLERY = "android.app.role.SYSTEM_GALLERY": String!

The name of the system gallery role.

You can not request for this role because it's hidden and only for system apps. It's meant to be granted out-of-the-box to a gallery app that shipped with the device.

The application will gain full read and write access to all image and video files on external storage, including access to location metadata.