Here you will find status messages, alerts, and errors that should be handled by a partner app.
Errors are implemented as a number of exception classes that will be delivered through callbacks when they occur. By investigating the type of the error, implementations can chose the right course of action.
Connection errors are delivered through the on
onFailure method of
Connection errors can occur at any time from that a clients calls
connect up until the time the
client has disconnected. The following comprises a list of errors that can be delivered through the
The Spotify app is not installed on the device. The Spotify Android app must be installed on the user's device in order for the Spotify App Remote SDK to work. Please see the "Installing Spotify" section of the Content Linking guide on how to direct users to download Spotify.
No one is logged in to the Spotify app on this device. Guide the user to log in to Spotify and try again.
Partner app failed to authenticate with Spotify. Check client credentials and make sure your app is registered correctly at developer.spotify.com
Indicates the user did not authorize this client of App Remote to use Spotify on the users behalf.
You need to make sure they approve
app-remote-control scope first. For details see the "Authorize
your application" section in the tutorial
Spotify app can't support requested features. User should update Spotify app.
Spotify user has set their Spotify app to be in offline mode, but app remote requires a call to be made to the backend. The user needs to disable offline mode in the Spotify app.
The Spotify app was/is disconnected by the Spotify app. This indicates typically that the Spotify app was closed by the user or for other reasons. You need to reconnect to continue using Spotify App Remote.
The connection to the Spotify app was unexpectedly terminated. Spotify might have crashed or was killed by the system. You need to reconnect to continue using Spotify App Remote.
IllegalStateException errors thrown by Context#startService(Intent) and Context#startForegroundService(Intent).
SecurityException - If the caller does not have permission to access the service or the service can not be found.
IllegalStateException - If the application is in a state where the service can not be started, be found, or be accessed (such as not in the foreground in a state when services are allowed).