added in version 24.1.0
belongs to Maven artifact com.android.support:customtabs:28.0.0-alpha1

CustomTabsService

public abstract class CustomTabsService
extends Service

java.lang.Object
↳	android.content.Context
	↳	android.content.ContextWrapper
		↳	android.app.Service
			↳	android.support.customtabs.CustomTabsService

Abstract service class for implementing Custom Tabs related functionality. The service should be responding to the action ACTION_CUSTOM_TABS_CONNECTION. This class should be used by implementers that want to provide Custom Tabs functionality, not by clients that want to launch Custom Tabs.

Summary

Nested classes
`@interface`	`CustomTabsService.Relation`
`@interface`	`CustomTabsService.Result`

Constants
`String`	`ACTION_CUSTOM_TABS_CONNECTION` The Intent action that a CustomTabsService must respond to.
`String`	`KEY_URL` For `mayLaunchUrl(CustomTabsSessionToken, Uri, Bundle, List)` calls that wants to specify more than one url, this key can be used with `putParcelable(String, android.os.Parcelable)` to insert a new url to each bundle inside list of bundles.
`int`	`RELATION_HANDLE_ALL_URLS` Used for `validateRelationship(int, Uri, Bundle)`.
`int`	`RELATION_USE_AS_ORIGIN` Used for `validateRelationship(int, Uri, Bundle)`.
`int`	`RESULT_FAILURE_DISALLOWED` Indicates that the postMessage request was not allowed due to a bad argument or requesting at a disallowed time like when in background.
`int`	`RESULT_FAILURE_MESSAGING_ERROR` Indicates that the postMessage request has failed due to an internal error on the browser message channel.
`int`	`RESULT_FAILURE_REMOTE_ERROR` Indicates that the postMessage request has failed due to a `RemoteException` .
`int`	`RESULT_SUCCESS` Indicates that the postMessage request was accepted.

Inherited constants

From class


    android.app.Service

From class


    android.content.Context

`String`	`ACCESSIBILITY_SERVICE`
`String`	`ACCOUNT_SERVICE`
`String`	`ACTIVITY_SERVICE`
`String`	`ALARM_SERVICE`
`String`	`APPWIDGET_SERVICE`
`String`	`APP_OPS_SERVICE`
`String`	`AUDIO_SERVICE`
`String`	`BATTERY_SERVICE`
`int`	`BIND_ABOVE_CLIENT`
`int`	`BIND_ADJUST_WITH_ACTIVITY`
`int`	`BIND_ALLOW_OOM_MANAGEMENT`
`int`	`BIND_AUTO_CREATE`
`int`	`BIND_DEBUG_UNBIND`
`int`	`BIND_EXTERNAL_SERVICE`
`int`	`BIND_IMPORTANT`
`int`	`BIND_NOT_FOREGROUND`
`int`	`BIND_WAIVE_PRIORITY`
`String`	`BLUETOOTH_SERVICE`
`String`	`CAMERA_SERVICE`
`String`	`CAPTIONING_SERVICE`
`String`	`CARRIER_CONFIG_SERVICE`
`String`	`CLIPBOARD_SERVICE`
`String`	`COMPANION_DEVICE_SERVICE`
`String`	`CONNECTIVITY_SERVICE`
`String`	`CONSUMER_IR_SERVICE`
`int`	`CONTEXT_IGNORE_SECURITY`
`int`	`CONTEXT_INCLUDE_CODE`
`int`	`CONTEXT_RESTRICTED`
`String`	`CROSS_PROFILE_APPS_SERVICE`
`String`	`DEVICE_POLICY_SERVICE`
`String`	`DISPLAY_SERVICE`
`String`	`DOWNLOAD_SERVICE`
`String`	`DROPBOX_SERVICE`
`String`	`FINGERPRINT_SERVICE`
`String`	`HARDWARE_PROPERTIES_SERVICE`
`String`	`INPUT_METHOD_SERVICE`
`String`	`INPUT_SERVICE`
`String`	`IPSEC_SERVICE`
`String`	`JOB_SCHEDULER_SERVICE`
`String`	`KEYGUARD_SERVICE`
`String`	`LAUNCHER_APPS_SERVICE`
`String`	`LAYOUT_INFLATER_SERVICE`
`String`	`LOCATION_SERVICE`
`String`	`MEDIA_PROJECTION_SERVICE`
`String`	`MEDIA_ROUTER_SERVICE`
`String`	`MEDIA_SESSION_SERVICE`
`String`	`MIDI_SERVICE`
`int`	`MODE_APPEND`
`int`	`MODE_ENABLE_WRITE_AHEAD_LOGGING`
`int`	`MODE_MULTI_PROCESS`
`int`	`MODE_NO_LOCALIZED_COLLATORS`
`int`	`MODE_PRIVATE`
`int`	`MODE_WORLD_READABLE`
`int`	`MODE_WORLD_WRITEABLE`
`String`	`NETWORK_STATS_SERVICE`
`String`	`NFC_SERVICE`
`String`	`NOTIFICATION_SERVICE`
`String`	`NSD_SERVICE`
`String`	`POWER_SERVICE`
`String`	`PRINT_SERVICE`
`int`	`RECEIVER_VISIBLE_TO_INSTANT_APPS`
`String`	`RESTRICTIONS_SERVICE`
`String`	`SEARCH_SERVICE`
`String`	`SENSOR_SERVICE`
`String`	`SHORTCUT_SERVICE`
`String`	`STORAGE_SERVICE`
`String`	`STORAGE_STATS_SERVICE`
`String`	`SYSTEM_HEALTH_SERVICE`
`String`	`TELECOM_SERVICE`
`String`	`TELEPHONY_SERVICE`
`String`	`TELEPHONY_SUBSCRIPTION_SERVICE`
`String`	`TEXT_CLASSIFICATION_SERVICE`
`String`	`TEXT_SERVICES_MANAGER_SERVICE`
`String`	`TV_INPUT_SERVICE`
`String`	`UI_MODE_SERVICE`
`String`	`USAGE_STATS_SERVICE`
`String`	`USB_SERVICE`
`String`	`USER_SERVICE`
`String`	`VIBRATOR_SERVICE`
`String`	`WALLPAPER_SERVICE`
`String`	`WIFI_AWARE_SERVICE`
`String`	`WIFI_P2P_SERVICE`
`String`	`WIFI_RTT_RANGING_SERVICE`
`String`	`WIFI_SERVICE`
`String`	`WINDOW_SERVICE`

From interface


    android.content.ComponentCallbacks2

Public constructors
`CustomTabsService()`

Public methods
`IBinder`	`onBind(Intent intent)`

Protected methods
`boolean`	`cleanUpSession(CustomTabsSessionToken sessionToken)` Called when the client side `IBinder` for this `CustomTabsSessionToken` is dead.
`abstract Bundle`	`extraCommand(String commandName, Bundle args)` Unsupported commands that may be provided by the implementation.
`abstract boolean`	`mayLaunchUrl(CustomTabsSessionToken sessionToken, Uri url, Bundle extras, List<Bundle> otherLikelyBundles)` Tells the browser of a likely future navigation to a URL.
`abstract boolean`	`newSession(CustomTabsSessionToken sessionToken)` Creates a new session through an ICustomTabsService with the optional callback.
`abstract int`	`postMessage(CustomTabsSessionToken sessionToken, String message, Bundle extras)` Sends a postMessage request using the origin communicated via `requestPostMessageChannel(CustomTabsSessionToken, Uri)`.
`abstract boolean`	`requestPostMessageChannel(CustomTabsSessionToken sessionToken, Uri postMessageOrigin)` Sends a request to create a two way postMessage channel between the client and the browser linked with the given `CustomTabsSession`.
`abstract boolean`	`updateVisuals(CustomTabsSessionToken sessionToken, Bundle bundle)` Updates the visuals of custom tabs for the given session.
`abstract boolean`	`validateRelationship(CustomTabsSessionToken sessionToken, int relation, Uri origin, Bundle extras)` Request to validate a relationship between the application and an origin.
`abstract boolean`	`warmup(long flags)` Warms up the browser process asynchronously.

Inherited methods

From class


  
    android.app.Service

`void`	`dump(FileDescriptor arg0, PrintWriter arg1, String[] arg2)`
`final Application`	`getApplication()`
`abstract IBinder`	`onBind(Intent arg0)`
`void`	`onConfigurationChanged(Configuration arg0)`
`void`	`onCreate()`
`void`	`onDestroy()`
`void`	`onLowMemory()`
`void`	`onRebind(Intent arg0)`
`void`	`onStart(Intent arg0, int arg1)`
`int`	`onStartCommand(Intent arg0, int arg1, int arg2)`
`void`	`onTaskRemoved(Intent arg0)`
`void`	`onTrimMemory(int arg0)`
`boolean`	`onUnbind(Intent arg0)`
`final void`	`startForeground(int arg0, Notification arg1)`
`final void`	`stopForeground(int arg0)`
`final void`	`stopForeground(boolean arg0)`
`final void`	`stopSelf()`
`final void`	`stopSelf(int arg0)`
`final boolean`	`stopSelfResult(int arg0)`

From class


  
    android.content.ContextWrapper

`void`	`attachBaseContext(Context arg0)`
`boolean`	`bindService(Intent arg0, ServiceConnection arg1, int arg2)`
`int`	`checkCallingOrSelfPermission(String arg0)`
`int`	`checkCallingOrSelfUriPermission(Uri arg0, int arg1)`
`int`	`checkCallingPermission(String arg0)`
`int`	`checkCallingUriPermission(Uri arg0, int arg1)`
`int`	`checkPermission(String arg0, int arg1, int arg2)`
`int`	`checkSelfPermission(String arg0)`
`int`	`checkUriPermission(Uri arg0, String arg1, String arg2, int arg3, int arg4, int arg5)`
`int`	`checkUriPermission(Uri arg0, int arg1, int arg2, int arg3)`
`void`	`clearWallpaper()`
`Context`	`createConfigurationContext(Configuration arg0)`
`Context`	`createContextForSplit(String arg0)`
`Context`	`createDeviceProtectedStorageContext()`
`Context`	`createDisplayContext(Display arg0)`
`Context`	`createPackageContext(String arg0, int arg1)`
`String[]`	`databaseList()`
`boolean`	`deleteDatabase(String arg0)`
`boolean`	`deleteFile(String arg0)`
`boolean`	`deleteSharedPreferences(String arg0)`
`void`	`enforceCallingOrSelfPermission(String arg0, String arg1)`
`void`	`enforceCallingOrSelfUriPermission(Uri arg0, int arg1, String arg2)`
`void`	`enforceCallingPermission(String arg0, String arg1)`
`void`	`enforceCallingUriPermission(Uri arg0, int arg1, String arg2)`
`void`	`enforcePermission(String arg0, int arg1, int arg2, String arg3)`
`void`	`enforceUriPermission(Uri arg0, String arg1, String arg2, int arg3, int arg4, int arg5, String arg6)`
`void`	`enforceUriPermission(Uri arg0, int arg1, int arg2, int arg3, String arg4)`
`String[]`	`fileList()`
`Context`	`getApplicationContext()`
`ApplicationInfo`	`getApplicationInfo()`
`AssetManager`	`getAssets()`
`Context`	`getBaseContext()`
`File`	`getCacheDir()`
`ClassLoader`	`getClassLoader()`
`File`	`getCodeCacheDir()`
`ContentResolver`	`getContentResolver()`
`File`	`getDataDir()`
`File`	`getDatabasePath(String arg0)`
`File`	`getDir(String arg0, int arg1)`
`File`	`getExternalCacheDir()`
`File[]`	`getExternalCacheDirs()`
`File`	`getExternalFilesDir(String arg0)`
`File[]`	`getExternalFilesDirs(String arg0)`
`File[]`	`getExternalMediaDirs()`
`File`	`getFileStreamPath(String arg0)`
`File`	`getFilesDir()`
`Executor`	`getMainExecutor()`
`Looper`	`getMainLooper()`
`File`	`getNoBackupFilesDir()`
`File`	`getObbDir()`
`File[]`	`getObbDirs()`
`String`	`getPackageCodePath()`
`PackageManager`	`getPackageManager()`
`String`	`getPackageName()`
`String`	`getPackageResourcePath()`
`Resources`	`getResources()`
`SharedPreferences`	`getSharedPreferences(String arg0, int arg1)`
`Object`	`getSystemService(String arg0)`
`String`	`getSystemServiceName(Class<?> arg0)`
`Resources.Theme`	`getTheme()`
`Drawable`	`getWallpaper()`
`int`	`getWallpaperDesiredMinimumHeight()`
`int`	`getWallpaperDesiredMinimumWidth()`
`void`	`grantUriPermission(String arg0, Uri arg1, int arg2)`
`boolean`	`isDeviceProtectedStorage()`
`boolean`	`isRestricted()`
`boolean`	`moveDatabaseFrom(Context arg0, String arg1)`
`boolean`	`moveSharedPreferencesFrom(Context arg0, String arg1)`
`FileInputStream`	`openFileInput(String arg0)`
`FileOutputStream`	`openFileOutput(String arg0, int arg1)`
`SQLiteDatabase`	`openOrCreateDatabase(String arg0, int arg1, SQLiteDatabase.CursorFactory arg2, DatabaseErrorHandler arg3)`
`SQLiteDatabase`	`openOrCreateDatabase(String arg0, int arg1, SQLiteDatabase.CursorFactory arg2)`
`Drawable`	`peekWallpaper()`
`Intent`	`registerReceiver(BroadcastReceiver arg0, IntentFilter arg1)`
`Intent`	`registerReceiver(BroadcastReceiver arg0, IntentFilter arg1, int arg2)`
`Intent`	`registerReceiver(BroadcastReceiver arg0, IntentFilter arg1, String arg2, Handler arg3, int arg4)`
`Intent`	`registerReceiver(BroadcastReceiver arg0, IntentFilter arg1, String arg2, Handler arg3)`
`void`	`removeStickyBroadcast(Intent arg0)`
`void`	`removeStickyBroadcastAsUser(Intent arg0, UserHandle arg1)`
`void`	`revokeUriPermission(Uri arg0, int arg1)`
`void`	`revokeUriPermission(String arg0, Uri arg1, int arg2)`
`void`	`sendBroadcast(Intent arg0, String arg1)`
`void`	`sendBroadcast(Intent arg0)`
`void`	`sendBroadcastAsUser(Intent arg0, UserHandle arg1)`
`void`	`sendBroadcastAsUser(Intent arg0, UserHandle arg1, String arg2)`
`void`	`sendOrderedBroadcast(Intent arg0, String arg1, BroadcastReceiver arg2, Handler arg3, int arg4, String arg5, Bundle arg6)`
`void`	`sendOrderedBroadcast(Intent arg0, String arg1)`
`void`	`sendOrderedBroadcastAsUser(Intent arg0, UserHandle arg1, String arg2, BroadcastReceiver arg3, Handler arg4, int arg5, String arg6, Bundle arg7)`
`void`	`sendStickyBroadcast(Intent arg0)`
`void`	`sendStickyBroadcastAsUser(Intent arg0, UserHandle arg1)`
`void`	`sendStickyOrderedBroadcast(Intent arg0, BroadcastReceiver arg1, Handler arg2, int arg3, String arg4, Bundle arg5)`
`void`	`sendStickyOrderedBroadcastAsUser(Intent arg0, UserHandle arg1, BroadcastReceiver arg2, Handler arg3, int arg4, String arg5, Bundle arg6)`
`void`	`setTheme(int arg0)`
`void`	`setWallpaper(Bitmap arg0)`
`void`	`setWallpaper(InputStream arg0)`
`void`	`startActivities(Intent[] arg0, Bundle arg1)`
`void`	`startActivities(Intent[] arg0)`
`void`	`startActivity(Intent arg0)`
`void`	`startActivity(Intent arg0, Bundle arg1)`
`ComponentName`	`startForegroundService(Intent arg0)`
`boolean`	`startInstrumentation(ComponentName arg0, String arg1, Bundle arg2)`
`void`	`startIntentSender(IntentSender arg0, Intent arg1, int arg2, int arg3, int arg4)`
`void`	`startIntentSender(IntentSender arg0, Intent arg1, int arg2, int arg3, int arg4, Bundle arg5)`
`ComponentName`	`startService(Intent arg0)`
`boolean`	`stopService(Intent arg0)`
`void`	`unbindService(ServiceConnection arg0)`
`void`	`unregisterReceiver(BroadcastReceiver arg0)`

From class


  
    android.content.Context

`abstract boolean`	`bindService(Intent arg0, ServiceConnection arg1, int arg2)`
`abstract int`	`checkCallingOrSelfPermission(String arg0)`
`abstract int`	`checkCallingOrSelfUriPermission(Uri arg0, int arg1)`
`abstract int`	`checkCallingPermission(String arg0)`
`abstract int`	`checkCallingUriPermission(Uri arg0, int arg1)`
`abstract int`	`checkPermission(String arg0, int arg1, int arg2)`
`abstract int`	`checkSelfPermission(String arg0)`
`abstract int`	`checkUriPermission(Uri arg0, String arg1, String arg2, int arg3, int arg4, int arg5)`
`abstract int`	`checkUriPermission(Uri arg0, int arg1, int arg2, int arg3)`
`abstract void`	`clearWallpaper()`
`abstract Context`	`createConfigurationContext(Configuration arg0)`
`abstract Context`	`createContextForSplit(String arg0)`
`abstract Context`	`createDeviceProtectedStorageContext()`
`abstract Context`	`createDisplayContext(Display arg0)`
`abstract Context`	`createPackageContext(String arg0, int arg1)`
`abstract String[]`	`databaseList()`
`abstract boolean`	`deleteDatabase(String arg0)`
`abstract boolean`	`deleteFile(String arg0)`
`abstract boolean`	`deleteSharedPreferences(String arg0)`
`abstract void`	`enforceCallingOrSelfPermission(String arg0, String arg1)`
`abstract void`	`enforceCallingOrSelfUriPermission(Uri arg0, int arg1, String arg2)`
`abstract void`	`enforceCallingPermission(String arg0, String arg1)`
`abstract void`	`enforceCallingUriPermission(Uri arg0, int arg1, String arg2)`
`abstract void`	`enforcePermission(String arg0, int arg1, int arg2, String arg3)`
`abstract void`	`enforceUriPermission(Uri arg0, String arg1, String arg2, int arg3, int arg4, int arg5, String arg6)`
`abstract void`	`enforceUriPermission(Uri arg0, int arg1, int arg2, int arg3, String arg4)`
`abstract String[]`	`fileList()`
`abstract Context`	`getApplicationContext()`
`abstract ApplicationInfo`	`getApplicationInfo()`
`abstract AssetManager`	`getAssets()`
`abstract File`	`getCacheDir()`
`abstract ClassLoader`	`getClassLoader()`
`abstract File`	`getCodeCacheDir()`
`final int`	`getColor(int arg0)`
`final ColorStateList`	`getColorStateList(int arg0)`
`abstract ContentResolver`	`getContentResolver()`
`abstract File`	`getDataDir()`
`abstract File`	`getDatabasePath(String arg0)`
`abstract File`	`getDir(String arg0, int arg1)`
`final Drawable`	`getDrawable(int arg0)`
`abstract File`	`getExternalCacheDir()`
`abstract File[]`	`getExternalCacheDirs()`
`abstract File`	`getExternalFilesDir(String arg0)`
`abstract File[]`	`getExternalFilesDirs(String arg0)`
`abstract File[]`	`getExternalMediaDirs()`
`abstract File`	`getFileStreamPath(String arg0)`
`abstract File`	`getFilesDir()`
`Executor`	`getMainExecutor()`
`abstract Looper`	`getMainLooper()`
`abstract File`	`getNoBackupFilesDir()`
`abstract File`	`getObbDir()`
`abstract File[]`	`getObbDirs()`
`abstract String`	`getPackageCodePath()`
`abstract PackageManager`	`getPackageManager()`
`abstract String`	`getPackageName()`
`abstract String`	`getPackageResourcePath()`
`abstract Resources`	`getResources()`
`abstract SharedPreferences`	`getSharedPreferences(String arg0, int arg1)`
`final String`	`getString(int arg0, Object... arg1)`
`final String`	`getString(int arg0)`
`final <T> T`	`getSystemService(Class<T> arg0)`
`abstract Object`	`getSystemService(String arg0)`
`abstract String`	`getSystemServiceName(Class<?> arg0)`
`final CharSequence`	`getText(int arg0)`
`abstract Resources.Theme`	`getTheme()`
`abstract Drawable`	`getWallpaper()`
`abstract int`	`getWallpaperDesiredMinimumHeight()`
`abstract int`	`getWallpaperDesiredMinimumWidth()`
`abstract void`	`grantUriPermission(String arg0, Uri arg1, int arg2)`
`abstract boolean`	`isDeviceProtectedStorage()`
`boolean`	`isRestricted()`
`abstract boolean`	`moveDatabaseFrom(Context arg0, String arg1)`
`abstract boolean`	`moveSharedPreferencesFrom(Context arg0, String arg1)`
`final TypedArray`	`obtainStyledAttributes(AttributeSet arg0, int[] arg1)`
`final TypedArray`	`obtainStyledAttributes(AttributeSet arg0, int[] arg1, int arg2, int arg3)`
`final TypedArray`	`obtainStyledAttributes(int arg0, int[] arg1)`
`final TypedArray`	`obtainStyledAttributes(int[] arg0)`
`abstract FileInputStream`	`openFileInput(String arg0)`
`abstract FileOutputStream`	`openFileOutput(String arg0, int arg1)`
`abstract SQLiteDatabase`	`openOrCreateDatabase(String arg0, int arg1, SQLiteDatabase.CursorFactory arg2, DatabaseErrorHandler arg3)`
`abstract SQLiteDatabase`	`openOrCreateDatabase(String arg0, int arg1, SQLiteDatabase.CursorFactory arg2)`
`abstract Drawable`	`peekWallpaper()`
`void`	`registerComponentCallbacks(ComponentCallbacks arg0)`
`abstract Intent`	`registerReceiver(BroadcastReceiver arg0, IntentFilter arg1)`
`abstract Intent`	`registerReceiver(BroadcastReceiver arg0, IntentFilter arg1, int arg2)`
`abstract Intent`	`registerReceiver(BroadcastReceiver arg0, IntentFilter arg1, String arg2, Handler arg3, int arg4)`
`abstract Intent`	`registerReceiver(BroadcastReceiver arg0, IntentFilter arg1, String arg2, Handler arg3)`
`abstract void`	`removeStickyBroadcast(Intent arg0)`
`abstract void`	`removeStickyBroadcastAsUser(Intent arg0, UserHandle arg1)`
`abstract void`	`revokeUriPermission(Uri arg0, int arg1)`
`abstract void`	`revokeUriPermission(String arg0, Uri arg1, int arg2)`
`abstract void`	`sendBroadcast(Intent arg0, String arg1)`
`abstract void`	`sendBroadcast(Intent arg0)`
`abstract void`	`sendBroadcastAsUser(Intent arg0, UserHandle arg1)`
`abstract void`	`sendBroadcastAsUser(Intent arg0, UserHandle arg1, String arg2)`
`abstract void`	`sendOrderedBroadcast(Intent arg0, String arg1, BroadcastReceiver arg2, Handler arg3, int arg4, String arg5, Bundle arg6)`
`abstract void`	`sendOrderedBroadcast(Intent arg0, String arg1)`
`abstract void`	`sendOrderedBroadcastAsUser(Intent arg0, UserHandle arg1, String arg2, BroadcastReceiver arg3, Handler arg4, int arg5, String arg6, Bundle arg7)`
`abstract void`	`sendStickyBroadcast(Intent arg0)`
`abstract void`	`sendStickyBroadcastAsUser(Intent arg0, UserHandle arg1)`
`abstract void`	`sendStickyOrderedBroadcast(Intent arg0, BroadcastReceiver arg1, Handler arg2, int arg3, String arg4, Bundle arg5)`
`abstract void`	`sendStickyOrderedBroadcastAsUser(Intent arg0, UserHandle arg1, BroadcastReceiver arg2, Handler arg3, int arg4, String arg5, Bundle arg6)`
`abstract void`	`setTheme(int arg0)`
`abstract void`	`setWallpaper(Bitmap arg0)`
`abstract void`	`setWallpaper(InputStream arg0)`
`abstract void`	`startActivities(Intent[] arg0, Bundle arg1)`
`abstract void`	`startActivities(Intent[] arg0)`
`abstract void`	`startActivity(Intent arg0)`
`abstract void`	`startActivity(Intent arg0, Bundle arg1)`
`abstract ComponentName`	`startForegroundService(Intent arg0)`
`abstract boolean`	`startInstrumentation(ComponentName arg0, String arg1, Bundle arg2)`
`abstract void`	`startIntentSender(IntentSender arg0, Intent arg1, int arg2, int arg3, int arg4)`
`abstract void`	`startIntentSender(IntentSender arg0, Intent arg1, int arg2, int arg3, int arg4, Bundle arg5)`
`abstract ComponentName`	`startService(Intent arg0)`
`abstract boolean`	`stopService(Intent arg0)`
`abstract void`	`unbindService(ServiceConnection arg0)`
`void`	`unregisterComponentCallbacks(ComponentCallbacks arg0)`
`abstract void`	`unregisterReceiver(BroadcastReceiver arg0)`

From class


  
    java.lang.Object

From interface


  
    android.content.ComponentCallbacks2

From interface


  
    android.content.ComponentCallbacks

Constants

ACTION_CUSTOM_TABS_CONNECTION

added in version 24.1.0

String ACTION_CUSTOM_TABS_CONNECTION

The Intent action that a CustomTabsService must respond to.

Constant Value: "android.support.customtabs.action.CustomTabsService"

KEY_URL

added in version 24.1.0

String KEY_URL

For mayLaunchUrl(CustomTabsSessionToken, Uri, Bundle, List) calls that wants to specify more than one url, this key can be used with putParcelable(String, android.os.Parcelable) to insert a new url to each bundle inside list of bundles.

Constant Value: "android.support.customtabs.otherurls.URL"

RELATION_HANDLE_ALL_URLS

added in version 27.1.0

int RELATION_HANDLE_ALL_URLS

Used for validateRelationship(int, Uri, Bundle). Requests the ability to handle all URLs from a given origin.

Constant Value: 2 (0x00000002)

RELATION_USE_AS_ORIGIN

added in version 27.1.0

int RELATION_USE_AS_ORIGIN

Used for validateRelationship(int, Uri, Bundle). For App -> Web transitions, requests the app to use the declared origin to be used as origin for the client app in the web APIs context.

Constant Value: 1 (0x00000001)

RESULT_FAILURE_DISALLOWED

added in version 25.4.0

int RESULT_FAILURE_DISALLOWED

Indicates that the postMessage request was not allowed due to a bad argument or requesting at a disallowed time like when in background.

Constant Value: -1 (0xffffffff)

RESULT_FAILURE_MESSAGING_ERROR

added in version 25.4.0

int RESULT_FAILURE_MESSAGING_ERROR

Indicates that the postMessage request has failed due to an internal error on the browser message channel.

Constant Value: -3 (0xfffffffd)

RESULT_FAILURE_REMOTE_ERROR

added in version 25.4.0

int RESULT_FAILURE_REMOTE_ERROR

Indicates that the postMessage request has failed due to a RemoteException .

Constant Value: -2 (0xfffffffe)

RESULT_SUCCESS

added in version 25.4.0

int RESULT_SUCCESS

Indicates that the postMessage request was accepted.

Constant Value: 0 (0x00000000)

Public constructors

CustomTabsService

added in version 24.1.0

CustomTabsService ()

Public methods

onBind

added in version 24.1.0

IBinder onBind (Intent intent)

Parameters
`intent`	`Intent`

Returns
`IBinder`

Protected methods

cleanUpSession

added in version 24.1.0

boolean cleanUpSession (CustomTabsSessionToken sessionToken)

Called when the client side IBinder for this CustomTabsSessionToken is dead. Can also be used to clean up IBinder.DeathRecipient instances allocated for the given token.

Parameters
`sessionToken`	`CustomTabsSessionToken`: The session token for which the `IBinder.DeathRecipient` call has been received.

Returns
`boolean`	Whether the clean up was successful. Multiple calls with two tokens holdings the same binder will return false.

extraCommand

added in version 24.1.0

Bundle extraCommand (String commandName, 
                Bundle args)

Unsupported commands that may be provided by the implementation.

Note:Clients should never rely on this method to have a defined behavior, as it is entirely implementation-defined and not supported.

This call can be used by implementations to add extra commands, for testing or experimental purposes.

Parameters
`commandName`	`String`: Name of the extra command to execute.
`args`	`Bundle`: Arguments for the command

Returns
`Bundle`	The result `Bundle`, or null.

mayLaunchUrl

added in version 24.1.0

boolean mayLaunchUrl (CustomTabsSessionToken sessionToken, 
                Uri url, 
                Bundle extras, 
                List<Bundle> otherLikelyBundles)

Tells the browser of a likely future navigation to a URL.

The method warmup(long) has to be called beforehand. The most likely URL has to be specified explicitly. Optionally, a list of other likely URLs can be provided. They are treated as less likely than the first one, and have to be sorted in decreasing priority order. These additional URLs may be ignored. All previous calls to this method will be deprioritized.

Parameters
`sessionToken`	`CustomTabsSessionToken`: The unique identifier for the session. Can not be null.
`url`	`Uri`: Most likely URL.
`extras`	`Bundle`: Reserved for future use.
`otherLikelyBundles`	`List`: Other likely destinations, sorted in decreasing likelihood order. Each Bundle has to provide a url.

Returns
`boolean`	Whether the call was successful.

newSession

added in version 24.1.0

boolean newSession (CustomTabsSessionToken sessionToken)

Creates a new session through an ICustomTabsService with the optional callback. This session can be used to associate any related communication through the service with an intent and then later with a Custom Tab. The client can then send later service calls or intents to through same session-intent-Custom Tab association.

Parameters
`sessionToken`	`CustomTabsSessionToken`: Session token to be used as a unique identifier. This also has access to the `CustomTabsCallback` passed from the client side through `getCallback()`.

Returns
`boolean`	Whether a new session was successfully created.

postMessage

added in version 25.4.0

int postMessage (CustomTabsSessionToken sessionToken, 
                String message, 
                Bundle extras)

Sends a postMessage request using the origin communicated via requestPostMessageChannel(CustomTabsSessionToken, Uri). Fails when called before notifyMessageChannelReady(Bundle) is received on the client side.

Parameters
`sessionToken`	`CustomTabsSessionToken`: The unique identifier for the session. Can not be null.
`message`	`String`: The message that is being sent.
`extras`	`Bundle`: Reserved for future use.

Returns
`int`	An integer constant about the postMessage request result. Will return `RESULT_SUCCESS` if successful.

requestPostMessageChannel

added in version 25.4.0

boolean requestPostMessageChannel (CustomTabsSessionToken sessionToken, 
                Uri postMessageOrigin)

Sends a request to create a two way postMessage channel between the client and the browser linked with the given CustomTabsSession.

Parameters
`sessionToken`	`CustomTabsSessionToken`: The unique identifier for the session. Can not be null.
`postMessageOrigin`	`Uri`: A origin that the client is requesting to be identified as during the postMessage communication.

Returns
`boolean`	Whether the implementation accepted the request. Note that returning true here doesn't mean an origin has already been assigned as the validation is asynchronous.

updateVisuals

added in version 24.1.0

boolean updateVisuals (CustomTabsSessionToken sessionToken, 
                Bundle bundle)

Updates the visuals of custom tabs for the given session. Will only succeed if the given session matches the currently active one.

Parameters
`sessionToken`	`CustomTabsSessionToken`: The currently active session that the custom tab belongs to.
`bundle`	`Bundle`: The action button configuration bundle. This bundle should be constructed with the same structure in `CustomTabsIntent.Builder`.

Returns
`boolean`	Whether the operation was successful.

validateRelationship

added in version 27.1.0

boolean validateRelationship (CustomTabsSessionToken sessionToken, 
                int relation, 
                Uri origin, 
                Bundle extras)

Request to validate a relationship between the application and an origin. If this method returns true, the validation result will be provided through onRelationshipValidationResult(int, Uri, boolean, Bundle). Otherwise the request didn't succeed. The client must call warmup(long) before this.

Parameters
`sessionToken`	`CustomTabsSessionToken`: The unique identifier for the session. Can not be null.
`relation`	`int`: Relation to check, must be one of the `CustomTabsService#RELATION_*` constants.
`origin`	`Uri`: Origin for the relation query.
`extras`	`Bundle`: Reserved for future use.

Returns
`boolean`	true if the request has been submitted successfully.

warmup

added in version 24.1.0

boolean warmup (long flags)

Warms up the browser process asynchronously.

Parameters
`flags`	`long`: Reserved for future use.

Returns
`boolean`	Whether warmup was/had been completed successfully. Multiple successful calls will return true.

CustomTabsService

Summary

Nested classes

Constants

Inherited constants

Public constructors

Public methods

Protected methods

Inherited methods

Constants

ACTION_CUSTOM_TABS_CONNECTION

KEY_URL

RELATION_HANDLE_ALL_URLS

RELATION_USE_AS_ORIGIN

RESULT_FAILURE_DISALLOWED

RESULT_FAILURE_MESSAGING_ERROR

RESULT_FAILURE_REMOTE_ERROR

RESULT_SUCCESS

Public constructors

CustomTabsService

Public methods

onBind

Protected methods

cleanUpSession

extraCommand

mayLaunchUrl

newSession

postMessage

requestPostMessageChannel

updateVisuals

validateRelationship

warmup

Annotations

Classes