Skip to content

Most visited

Recently visited

navigation
added in API level 1

ServiceConnection

public interface ServiceConnection

android.content.ServiceConnection
Known Indirect Subclasses


Interface for monitoring the state of an application service. See Service and Context.bindService() for more information.

Like many callbacks from the system, the methods on this class are called from the main thread of your process.

Summary

Public methods

default void onBindingDied(ComponentName name)

Called when the binding to this connection is dead.

abstract void onServiceConnected(ComponentName name, IBinder service)

Called when a connection to the Service has been established, with the IBinder of the communication channel to the Service.

abstract void onServiceDisconnected(ComponentName name)

Called when a connection to the Service has been lost.

Public methods

onBindingDied

added in API level 26
void onBindingDied (ComponentName name)

Called when the binding to this connection is dead. This means the interface will never receive another connection. The application will need to unbind and rebind the connection to activate it again. This may happen, for example, if the application hosting the service it is bound to has been updated.

Parameters
name ComponentName: The concrete component name of the service whose connection is dead.

onServiceConnected

added in API level 1
void onServiceConnected (ComponentName name, 
                IBinder service)

Called when a connection to the Service has been established, with the IBinder of the communication channel to the Service.

Parameters
name ComponentName: The concrete component name of the service that has been connected.

service IBinder: The IBinder of the Service's communication channel, which you can now make calls on.

onServiceDisconnected

added in API level 1
void onServiceDisconnected (ComponentName name)

Called when a connection to the Service has been lost. This typically happens when the process hosting the service has crashed or been killed. This does not remove the ServiceConnection itself -- this binding to the service will remain active, and you will receive a call to onServiceConnected(ComponentName, IBinder) when the Service is next running.

Parameters
name ComponentName: The concrete component name of the service whose connection has been lost.

This site uses cookies to store your preferences for site-specific language and display options.

Get the latest Android developer news and tips that will help you find success on Google Play.

* Required Fields

Hooray!

Browse this site in ?

You requested a page in , but your language preference for this site is .

Would you like to change your language preference and browse this site in ? If you want to change your language preference later, use the language menu at the bottom of each page.

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.

Take a short survey?
Help us improve the Android developer experience.
(Sep 2017 survey)