public abstract class ADMMessageHandlerBase
extends android.app.IntentService
ADMMessageReceiver
. For an example of using this class,
see Integrating Your App with ADM.
All methods on this class are called on a background thread with a wake lock held. It is safe to do long-running operations in these methods.
START_CONTINUATION_MASK, START_FLAG_REDELIVERY, START_FLAG_RETRY, START_NOT_STICKY, START_REDELIVER_INTENT, START_STICKY, START_STICKY_COMPATIBILITY, STOP_FOREGROUND_DETACH, STOP_FOREGROUND_REMOVE
ACCESSIBILITY_SERVICE, ACCOUNT_SERVICE, ACTIVITY_SERVICE, ALARM_SERVICE, APP_OPS_SERVICE, APPWIDGET_SERVICE, AUDIO_SERVICE, BATTERY_SERVICE, BIND_ABOVE_CLIENT, BIND_ADJUST_WITH_ACTIVITY, BIND_ALLOW_OOM_MANAGEMENT, BIND_AUTO_CREATE, BIND_DEBUG_UNBIND, BIND_EXTERNAL_SERVICE, BIND_IMPORTANT, BIND_NOT_FOREGROUND, BIND_WAIVE_PRIORITY, BLUETOOTH_SERVICE, CAMERA_SERVICE, CAPTIONING_SERVICE, CARRIER_CONFIG_SERVICE, CLIPBOARD_SERVICE, COMPANION_DEVICE_SERVICE, CONNECTIVITY_SERVICE, CONSUMER_IR_SERVICE, CONTEXT_IGNORE_SECURITY, CONTEXT_INCLUDE_CODE, CONTEXT_RESTRICTED, DEVICE_POLICY_SERVICE, DISPLAY_SERVICE, DOWNLOAD_SERVICE, DROPBOX_SERVICE, FINGERPRINT_SERVICE, HARDWARE_PROPERTIES_SERVICE, INPUT_METHOD_SERVICE, INPUT_SERVICE, JOB_SCHEDULER_SERVICE, KEYGUARD_SERVICE, LAUNCHER_APPS_SERVICE, LAYOUT_INFLATER_SERVICE, LOCATION_SERVICE, MEDIA_PROJECTION_SERVICE, MEDIA_ROUTER_SERVICE, MEDIA_SESSION_SERVICE, MIDI_SERVICE, MODE_APPEND, MODE_ENABLE_WRITE_AHEAD_LOGGING, MODE_MULTI_PROCESS, MODE_NO_LOCALIZED_COLLATORS, MODE_PRIVATE, MODE_WORLD_READABLE, MODE_WORLD_WRITEABLE, NETWORK_STATS_SERVICE, NFC_SERVICE, NOTIFICATION_SERVICE, NSD_SERVICE, POWER_SERVICE, PRINT_SERVICE, RECEIVER_VISIBLE_TO_INSTANT_APPS, RESTRICTIONS_SERVICE, SEARCH_SERVICE, SENSOR_SERVICE, SHORTCUT_SERVICE, STORAGE_SERVICE, STORAGE_STATS_SERVICE, SYSTEM_HEALTH_SERVICE, TELECOM_SERVICE, TELEPHONY_SERVICE, TELEPHONY_SUBSCRIPTION_SERVICE, TEXT_CLASSIFICATION_SERVICE, TEXT_SERVICES_MANAGER_SERVICE, TV_INPUT_SERVICE, UI_MODE_SERVICE, USAGE_STATS_SERVICE, USB_SERVICE, USER_SERVICE, VIBRATOR_SERVICE, WALLPAPER_SERVICE, WIFI_AWARE_SERVICE, WIFI_P2P_SERVICE, WIFI_SERVICE, WINDOW_SERVICE
Modifier | Constructor and Description |
---|---|
protected |
ADMMessageHandlerBase(java.lang.String className)
Protected constructor for creating an instance of
ADMMessageHandlerBase . |
Modifier and Type | Method and Description |
---|---|
protected void |
onHandleIntent(android.content.Intent intent) |
protected abstract void |
onMessage(android.content.Intent intent)
Called each time ADM delivers a message to an instance of your app.
|
protected abstract void |
onRegistered(java.lang.String registrationId)
Called when a registration request succeeds.
|
protected abstract void |
onRegistrationError(java.lang.String errorId)
Called when a registration request fails.
|
protected void |
onSubscribe(java.lang.String topic)
Called on successful subscription to a topic.
|
protected void |
onSubscribeError(java.lang.String topic,
java.lang.String errorId)
Called when a subscription request fails.
|
protected abstract void |
onUnregistered(java.lang.String registrationId)
Called on successful unregistration.
|
protected void |
onUnsubscribe(java.lang.String topic)
Called on successful unsubscription from a topic.
|
protected void |
onUnsubscribeError(java.lang.String topic,
java.lang.String errorId)
Called when a unsubscription request fails.
|
onBind, onCreate, onDestroy, onStart, onStartCommand, setIntentRedelivery
dump, getApplication, onConfigurationChanged, onLowMemory, onRebind, onTaskRemoved, onTrimMemory, onUnbind, startForeground, stopForeground, stopForeground, stopSelf, stopSelf, stopSelfResult
attachBaseContext, bindService, checkCallingOrSelfPermission, checkCallingOrSelfUriPermission, checkCallingPermission, checkCallingUriPermission, checkPermission, checkSelfPermission, checkUriPermission, checkUriPermission, clearWallpaper, createConfigurationContext, createContextForSplit, createDeviceProtectedStorageContext, createDisplayContext, createPackageContext, databaseList, deleteDatabase, deleteFile, deleteSharedPreferences, enforceCallingOrSelfPermission, enforceCallingOrSelfUriPermission, enforceCallingPermission, enforceCallingUriPermission, enforcePermission, enforceUriPermission, enforceUriPermission, fileList, getApplicationContext, getApplicationInfo, getAssets, getBaseContext, getCacheDir, getClassLoader, getCodeCacheDir, getContentResolver, getDatabasePath, getDataDir, getDir, getExternalCacheDir, getExternalCacheDirs, getExternalFilesDir, getExternalFilesDirs, getExternalMediaDirs, getFilesDir, getFileStreamPath, getMainLooper, getNoBackupFilesDir, getObbDir, getObbDirs, getPackageCodePath, getPackageManager, getPackageName, getPackageResourcePath, getResources, getSharedPreferences, getSystemService, getSystemServiceName, getTheme, getWallpaper, getWallpaperDesiredMinimumHeight, getWallpaperDesiredMinimumWidth, grantUriPermission, isDeviceProtectedStorage, isRestricted, moveDatabaseFrom, moveSharedPreferencesFrom, openFileInput, openFileOutput, openOrCreateDatabase, openOrCreateDatabase, peekWallpaper, registerReceiver, registerReceiver, registerReceiver, registerReceiver, removeStickyBroadcast, removeStickyBroadcastAsUser, revokeUriPermission, revokeUriPermission, sendBroadcast, sendBroadcast, sendBroadcastAsUser, sendBroadcastAsUser, sendOrderedBroadcast, sendOrderedBroadcast, sendOrderedBroadcastAsUser, sendStickyBroadcast, sendStickyBroadcastAsUser, sendStickyOrderedBroadcast, sendStickyOrderedBroadcastAsUser, setTheme, setWallpaper, setWallpaper, startActivities, startActivities, startActivity, startActivity, startForegroundService, startInstrumentation, startIntentSender, startIntentSender, startService, stopService, unbindService, unregisterReceiver
protected ADMMessageHandlerBase(java.lang.String className)
ADMMessageHandlerBase
.className
- A name for this thread, for debugging purposes.protected final void onHandleIntent(android.content.Intent intent)
onHandleIntent
in class android.app.IntentService
protected abstract void onMessage(android.content.Intent intent)
intent
- An intent containing the message and associated data.
You extract the message content from the set of extras attached to the
com.amazon.device.messaging.intent.RECEIVE
intent. For an example of defining
the behavior of the onMessage()
callback, see
SampleADMMessageHandler.java
in the ADMMessenger sample app.protected abstract void onRegistrationError(java.lang.String errorId)
errorId
- one of the following values:
protected abstract void onRegistered(java.lang.String registrationId)
ADM.startRegister()
or if ADM has updated
the registration ID for this app instance.registrationId
- The new registration ID for the instance of your app. Pass this
value to your components that are using ADM to send messages. The
ADM.getRegistrationId()
method also
obtains the registration ID for an instance of your app.protected abstract void onUnregistered(java.lang.String registrationId)
ADM.startUnregister()
or if ADM has unregistered the
app for some reason (typically because the device has lost its association with a user's
Amazon account). If this message is called, your app should notify your components
that are using ADM to send messages, so that they know this instance of your app is no longer
a valid recipient.registrationId
- The registration ID for the instance of your app that is now unregistered.
This ID is no longer a valid destination for messages.
Calling ADM.getRegistrationId()
will show the registration ID for an unregistered app as null
.protected void onSubscribe(java.lang.String topic)
ADM.subscribeToTopic(String)
Topic()}topic
- topic the app is subscribed toprotected void onSubscribeError(java.lang.String topic, java.lang.String errorId)
topic
- topic the app was trying to subscribe toerrorId
- one of the following values:protected void onUnsubscribe(java.lang.String topic)
ADM.unsubscribeFromTopic(String)
Topic()}topic
- topic the app is unsubscribed fromprotected void onUnsubscribeError(java.lang.String topic, java.lang.String errorId)
topic
- topic the app was trying to unsubscribe fromerrorId
- one of the following values: