com.moppyandroid.main.service

Class MoppyMediaService

java.lang.Object

android.content.Context

android.content.ContextWrapper

android.app.Service

androidx.media.MediaBrowserServiceCompat

com.moppyandroid.main.service.MoppyMediaService

All Implemented Interfaces:

ComponentCallbacks, ComponentCallbacks2

public class MoppyMediaService
extends MediaBrowserServiceCompat

The media service that controls Moppy playback.

Control of Moppy is offered through onCustomAction, while playback control is offered through MediaController. As with any MediaBrowserServiceCompat, content is available through onLoadChildren, and loading can be done either through ACTION_LOAD_ITEM or the MediaControllerCompat, with the main advantage of ACTION_LOAD_ITEM being that the user can supply callbacks for success and failure, while loading a file through the MediaController is fire-and-forget.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	MoppyMediaService.Binder Used to allow binding to this MoppyMediaService.

Nested classes/interfaces inherited from class androidx.media.MediaBrowserServiceCompat

MediaBrowserServiceCompat.BrowserRoot, MediaBrowserServiceCompat.Result<T>

Field Summary

Fields

Modifier and Type	Field and Description
static String	ACTION_ADD_DEVICE The custom action for adding a Moppy device.
static String	ACTION_GET_DEVICES The custom action for refreshing the available USB devices.
static String	ACTION_INIT_LIBRARY The custom action for triggering media library creation if not done so already.
static String	ACTION_LOAD_ITEM The custom action for loading a file.
static String	ACTION_REFRESH_DEVICES The custom action for refreshing the available USB devices.
static String	ACTION_REMOVE_DEVICE The custom action for removing a Moppy device.
static String	ACTION_SET_MIDI_IN The custom action for setting the MIDI device to receive input from.
static String	ACTION_SET_MIDI_OUT The custom action for setting the MIDI device to send output to.
static String	ACTION_SET_MIDI_SPLIT The custom action for setting the service to intercept MIDI messages from the MIDI input devices and split up chords to distribute their notes across available MIDI channels.
static String	CHANNEL_ID The ID for the media service notification channel.
static String	EXTRA_BIND_NORMAL boolean extra used to allow custom binding without using MediaBrowserServiceCompat.
static String	EXTRA_DEVICE_INFOS ArrayList<UsbDevice> (stored as ArrayList<Parcelable)>) extra field containing all available devices.
static String	EXTRA_DEVICE_NAMES ArrayList<String> extra field for the available device names.
static String	EXTRA_DEVICES_CONNECTED String extra field for the identifiers of connected devices.
static String	EXTRA_ERROR_INFORMATIONAL boolean extra field for if the error is informational and can be ignored.
static String	EXTRA_ERROR_REASON String extra field for the reason an error was raised.
static String	EXTRA_EXCEPTION Exception extra field (stored as Serializable) for a bundled exception.
static String	EXTRA_LIBRARY_CREATED boolean extra field for if the MidiLibrary was created successfully.
static String	EXTRA_MEDIA_ID String extra field for the media ID of the file to load.
static String	EXTRA_MEDIA_MIDI_FILE MidiLibrary.MidiFile extra field (stored as Parcelable) for the MIDI file loaded in an ACTION_LOAD_ITEM event.
static String	EXTRA_MIDI_IN_DEVICE MidiPortInfoWrapper extra field (stored as Parcelable) for the MIDI device associated with an ACTION_SET_MIDI_IN event.
static String	EXTRA_MIDI_OUT_DEVICE MidiPortInfoWrapper extra field (stored as Parcelable) for the MIDI device associated with an ACTION_SET_MIDI_OUT event.
static String	EXTRA_MIDI_SPLIT_ENABLE boolean extra field for whether or not to split incoming MIDI notes.
static String	EXTRA_NUM_CONNECTED int extra field for the number of connected devices.
static String	EXTRA_PLAY boolean extra field for if the sequencer should be started if file loaded successfully.
static String	EXTRA_PORT_NAME String extra field for the port name associated with a ACTION_ADD_DEVICE or ACTION_REMOVE_DEVICE event.

Fields inherited from class androidx.media.MediaBrowserServiceCompat

KEY_MEDIA_ITEM, KEY_SEARCH_RESULTS, RESULT_ERROR, RESULT_OK, RESULT_PROGRESS_UPDATE, SERVICE_INTERFACE

Fields inherited from class android.app.Service

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

Fields inherited from class android.content.Context

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_INCLUDE_CAPABILITIES, BIND_NOT_FOREGROUND, BIND_NOT_PERCEPTIBLE, BIND_WAIVE_PRIORITY, BIOMETRIC_SERVICE, 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, CROSS_PROFILE_APPS_SERVICE, DEVICE_POLICY_SERVICE, DISPLAY_SERVICE, DOWNLOAD_SERVICE, DROPBOX_SERVICE, EUICC_SERVICE, FINGERPRINT_SERVICE, HARDWARE_PROPERTIES_SERVICE, INPUT_METHOD_SERVICE, INPUT_SERVICE, IPSEC_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, ROLE_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_RTT_RANGING_SERVICE, WIFI_SERVICE, WINDOW_SERVICE

Fields inherited from interface android.content.ComponentCallbacks2

TRIM_MEMORY_BACKGROUND, TRIM_MEMORY_COMPLETE, TRIM_MEMORY_MODERATE, TRIM_MEMORY_RUNNING_CRITICAL, TRIM_MEMORY_RUNNING_LOW, TRIM_MEMORY_RUNNING_MODERATE, TRIM_MEMORY_UI_HIDDEN

Constructor Summary

Constructors

Constructor and Description
MoppyMediaService()

Method Summary

Modifier and Type	Method and Description
boolean	addReceiver(Receiver receiver) Adds a Receiver to forward all MIDI messages to, regardless of if they originated on the MIDI wire input or the MIDI file input.
Receiver	getInputReceiver() Gets the Receiver that can be used to send MIDI messages to Moppy.
Receiver	getReceiver() Gets the Receiver that messages are forwarded to.
boolean	load(String mediaId, boolean setToPlaying) Loads a MidiLibrary.MidiFile by its media ID into Moppy.
IBinder	onBind(Intent intent) Triggered when this service is bound to with Context.bindService(Intent, ServiceConnection, int).
void	onCreate() Triggered when the service is first created, usually by the first Context.startService(Intent) call.
void	onCustomAction(String action, Bundle extras, MediaBrowserServiceCompat.Result<Bundle> result) Called to request a custom action to this service.
void	onDestroy() Triggered when the service has completed and is being destroyed by the garbage collector.
MediaBrowserServiceCompat.BrowserRoot	onGetRoot(String clientPackageName, int clientUid, Bundle rootHints) Retrieves the node that allows a connecting client to browse the content library's root folder.
void	onLoadChildren(String parentMediaId, MediaBrowserServiceCompat.Result<List<MediaBrowserCompat.MediaItem>> result) Uses the provided media ID to retrieve the node's children, which are either browsable MediaBrowserCompat.MediaItems (folders) or playable MediaItems.
int	onStartCommand(Intent intent, int flags, int startId) Triggered when this service is started with a call to Context.startService(android.content.Intent).
void	onTaskRemoved(Intent rootIntent) Triggered when the activity is killed (e.g.
boolean	removeReceiver(Receiver receiver) Removes a Receiver from the list to forward messages to.

Methods inherited from class androidx.media.MediaBrowserServiceCompat

attachToBaseContext, dump, getBrowserRootHints, getCurrentBrowserInfo, getSessionToken, notifyChildrenChanged, notifyChildrenChanged, notifyChildrenChanged, onLoadChildren, onLoadItem, onSearch, onSubscribe, onUnsubscribe, setSessionToken

Methods inherited from class android.app.Service

getApplication, getForegroundServiceType, onConfigurationChanged, onLowMemory, onRebind, onStart, onTrimMemory, onUnbind, startForeground, startForeground, stopForeground, stopForeground, stopSelf, stopSelf, stopSelfResult

Methods inherited from class android.content.ContextWrapper

attachBaseContext, bindIsolatedService, bindService, 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, getMainExecutor, getMainLooper, getNoBackupFilesDir, getObbDir, getObbDirs, getOpPackageName, 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, updateServiceGroup

Methods inherited from class android.content.Context

getColor, getColorStateList, getDrawable, getString, getString, getSystemService, getText, obtainStyledAttributes, obtainStyledAttributes, obtainStyledAttributes, obtainStyledAttributes, registerComponentCallbacks, unregisterComponentCallbacks

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

CHANNEL_ID

public static final String CHANNEL_ID

The ID for the media service notification channel.

See Also:

Constant Field Values

ACTION_ADD_DEVICE

public static final String ACTION_ADD_DEVICE

The custom action for adding a Moppy device.

Non-standard Bundle fields required:

KEY	TYPE	VALUE
EXTRA_PORT_NAME	String	The provided port name
(Result only) EXTRA_NUM_CONNECTED	int	The number of currently connected devices

See Also:

onCustomAction, Constant Field Values

ACTION_REMOVE_DEVICE

public static final String ACTION_REMOVE_DEVICE

The custom action for removing a Moppy device.

Non-standard Bundle fields required:

KEY	TYPE	VALUE
EXTRA_PORT_NAME	String	The provided port name
(Result only) EXTRA_NUM_CONNECTED	int	The number of currently connected devices

EXTRA_ERROR_INFORMATIONAL may be true if the device wasn't connected or an IOException was raised while trying to disconnect.

See Also:

onCustomAction, Constant Field Values

ACTION_SET_MIDI_IN

public static final String ACTION_SET_MIDI_IN

The custom action for setting the MIDI device to receive input from.

Non-standard Bundle fields required:

KEY	TYPE	VALUE
EXTRA_MIDI_IN_DEVICE	MidiPortInfoWrapper (Parcelable)	The MIDI port to connect to

See Also:

onCustomAction, Constant Field Values

ACTION_SET_MIDI_OUT

public static final String ACTION_SET_MIDI_OUT

The custom action for setting the MIDI device to send output to.

Non-standard Bundle fields required:

KEY	TYPE	VALUE
EXTRA_MIDI_OUT_DEVICE	MidiPortInfoWrapper (Parcelable)	The MIDI port to connect to

See Also:

onCustomAction, Constant Field Values

ACTION_SET_MIDI_SPLIT

public static final String ACTION_SET_MIDI_SPLIT

The custom action for setting the service to intercept MIDI messages from the MIDI input devices and split up chords to distribute their notes across available MIDI channels.

Non-standard Bundle fields required:

KEY	TYPE	VALUE
EXTRA_MIDI_SPLIT_ENABLE	boolean	Whether or not to enable MIDI note splitting on the MIDI input devices

See Also:

onCustomAction, Constant Field Values

ACTION_INIT_LIBRARY

public static final String ACTION_INIT_LIBRARY

The custom action for triggering media library creation if not done so already. Strongly recommended to send this action after Manifest.permission.READ_EXTERNAL_STORAGE has been granted to the Activity.

Non-standard Bundle fields required:

KEY	TYPE	VALUE
(Result only) EXTRA_LIBRARY_CREATED	boolean	true if the library already exists or was created, or false if creation failed

See Also:

onCustomAction, Constant Field Values

ACTION_REFRESH_DEVICES

public static final String ACTION_REFRESH_DEVICES

The custom action for refreshing the available USB devices. Replicates ACTION_GET_DEVICES upon completion. Guaranteed to not send an error.

Non-standard Bundle fields: see ACTION_GET_DEVICES

See Also:

onCustomAction, Constant Field Values

ACTION_GET_DEVICES

public static final String ACTION_GET_DEVICES

The custom action for refreshing the available USB devices. Guaranteed to not send an error.

Non-standard Bundle fields required:

KEY	TYPE	VALUE
(Result only) EXTRA_DEVICE_NAMES	ArrayList{@literal <}{@link String}{@literal >}	The list of available port/device names
(Result only) EXTRA_DEVICE_INFOS	ArrayList<UsbDevice>	The list of device information lists
(Result only) EXTRA_NUM_CONNECTED	int	The number of currently connected devices
(Result only) EXTRA_DEVICES_CONNECTED	ArrayList<String>	The list of connected device identifiers
(Result only) EXTRA_MIDI_IN_DEVICE	MidiPortInfoWrapper (Parcelable)	The currently connected MIDI in device, or null if none connected
(Result only) EXTRA_MIDI_OUT_DEVICE	MidiPortInfoWrapper (Parcelable)	The currently connected MIDI out device, or null if none connected
(Result only) EXTRA_MIDI_SPLIT_ENABLE	boolean	Whether or not MIDI note splitting on the MIDI input devices are enabled

See Also:

onCustomAction, Constant Field Values

ACTION_LOAD_ITEM

public static final String ACTION_LOAD_ITEM

The custom action for loading a file.

Non-standard Bundle fields required:

KEY	TYPE	VALUE
EXTRA_MEDIA_ID	String	The media ID to load
(Optional) EXTRA_PLAY	boolean	Start playing after loading finished
(Result only) EXTRA_MEDIA_MIDI_FILE	MidiLibrary.MidiFile (Parcelable)	Information about the MIDI file that was loaded

See Also:

onLoadChildren, onCustomAction, Constant Field Values

EXTRA_BIND_NORMAL

public static final String EXTRA_BIND_NORMAL

boolean extra used to allow custom binding without using MediaBrowserServiceCompat.

See Also:

Constant Field Values

EXTRA_PORT_NAME

public static final String EXTRA_PORT_NAME

String extra field for the port name associated with a ACTION_ADD_DEVICE or ACTION_REMOVE_DEVICE event.

See Also:

Constant Field Values

EXTRA_MIDI_IN_DEVICE

public static final String EXTRA_MIDI_IN_DEVICE

MidiPortInfoWrapper extra field (stored as Parcelable) for the MIDI device associated with an ACTION_SET_MIDI_IN event.

See Also:

Constant Field Values

EXTRA_MIDI_OUT_DEVICE

public static final String EXTRA_MIDI_OUT_DEVICE

MidiPortInfoWrapper extra field (stored as Parcelable) for the MIDI device associated with an ACTION_SET_MIDI_OUT event.

See Also:

Constant Field Values

EXTRA_MIDI_SPLIT_ENABLE

public static final String EXTRA_MIDI_SPLIT_ENABLE

boolean extra field for whether or not to split incoming MIDI notes.

See Also:

Constant Field Values

EXTRA_LIBRARY_CREATED

public static final String EXTRA_LIBRARY_CREATED

boolean extra field for if the MidiLibrary was created successfully.

See Also:

Constant Field Values

EXTRA_DEVICE_NAMES

public static final String EXTRA_DEVICE_NAMES

ArrayList<String> extra field for the available device names.

See Also:

Constant Field Values

EXTRA_DEVICE_INFOS

public static final String EXTRA_DEVICE_INFOS

ArrayList<UsbDevice> (stored as ArrayList<Parcelable)>) extra field containing all available devices.

See Also:

MoppyUsbManager.getDeviceInfoForAll(), Constant Field Values

EXTRA_NUM_CONNECTED

public static final String EXTRA_NUM_CONNECTED

int extra field for the number of connected devices.

See Also:

Constant Field Values

EXTRA_DEVICES_CONNECTED

public static final String EXTRA_DEVICES_CONNECTED

String extra field for the identifiers of connected devices.

See Also:

Constant Field Values

EXTRA_MEDIA_ID

public static final String EXTRA_MEDIA_ID

String extra field for the media ID of the file to load.

See Also:

Constant Field Values

EXTRA_MEDIA_MIDI_FILE

public static final String EXTRA_MEDIA_MIDI_FILE

MidiLibrary.MidiFile extra field (stored as Parcelable) for the MIDI file loaded in an ACTION_LOAD_ITEM event.

See Also:

Constant Field Values

EXTRA_PLAY

public static final String EXTRA_PLAY

boolean extra field for if the sequencer should be started if file loaded successfully. If an action reads this extra, null represents false.

See Also:

load(String, boolean), Constant Field Values

EXTRA_EXCEPTION

public static final String EXTRA_EXCEPTION

Exception extra field (stored as Serializable) for a bundled exception.

See Also:

Constant Field Values

EXTRA_ERROR_REASON

public static final String EXTRA_ERROR_REASON

String extra field for the reason an error was raised.

See Also:

Constant Field Values

EXTRA_ERROR_INFORMATIONAL

public static final String EXTRA_ERROR_INFORMATIONAL

boolean extra field for if the error is informational and can be ignored.

See Also:

Constant Field Values

Constructor Detail

MoppyMediaService

public MoppyMediaService()

Method Detail

onCreate

public void onCreate()

Triggered when the service is first created, usually by the first Context.startService(Intent) call. Always triggered before onStartCommand(Intent, int, int).

Overrides:

onCreate in class MediaBrowserServiceCompat

onStartCommand

public int onStartCommand(Intent intent,
                          int flags,
                          int startId)

Triggered when this service is started with a call to Context.startService(android.content.Intent).

Overrides:

onStartCommand in class Service

Parameters:

intent - the intent used in the Context.startService call

flags - either 0, Service.START_FLAG_REDELIVERY, or Service.START_FLAG_RETRY

startId - unique identifier for this start instance, used with Service.stopSelfResult(int)

Returns:

flag for how the system should handle restarting the service, one of the Service.START_CONTINUATION_MASK flags

onBind

public IBinder onBind(Intent intent)

Triggered when this service is bound to with Context.bindService(Intent, ServiceConnection, int).

Overrides:

onBind in class MediaBrowserServiceCompat

Parameters:

intent - the Intent send with the bindService call

Returns:

a MoppyMediaService.Binder if EXTRA_BIND_NORMAL is specified and true, otherwise the result of MediaBrowserServiceCompat.onBind(Intent)

onTaskRemoved

public void onTaskRemoved(Intent rootIntent)

Triggered when the activity is killed (e.g. swipe up in recent apps, G.C.). Not called if the app is force killed.

Overrides:

onTaskRemoved in class Service

Parameters:

rootIntent - the intent used to launch the task being removed

onDestroy

public void onDestroy()

Triggered when the service has completed and is being destroyed by the garbage collector.

Overrides:

onDestroy in class Service

onGetRoot

public MediaBrowserServiceCompat.BrowserRoot onGetRoot(String clientPackageName,
                                                       int clientUid,
                                                       Bundle rootHints)

Retrieves the node that allows a connecting client to browse the content library's root folder.

Specified by:

onGetRoot in class MediaBrowserServiceCompat

Parameters:

clientPackageName - package name of the connecting client

clientUid - identifier of the connecting client

rootHints - hints about what content to return; ignored

Returns:

the root node browser

See Also:

MediaBrowserServiceCompat.BrowserRoot.EXTRA_RECENT, MediaBrowserServiceCompat.BrowserRoot.EXTRA_OFFLINE, MediaBrowserServiceCompat.BrowserRoot.EXTRA_SUGGESTED

onLoadChildren

public void onLoadChildren(String parentMediaId,
                           MediaBrowserServiceCompat.Result<List<MediaBrowserCompat.MediaItem>> result)

Uses the provided media ID to retrieve the node's children, which are either browsable MediaBrowserCompat.MediaItems (folders) or playable MediaItems.

Specified by:

onLoadChildren in class MediaBrowserServiceCompat

Parameters:

parentMediaId - the ID of the node to retrieve items from

result - where the list of MediaBrowserCompat.MediaItems contained in the parent node is sent to

See Also:

onGetRoot(String, int, Bundle)

onCustomAction

public void onCustomAction(@NonNull
                           String action,
                           Bundle extras,
                           @NonNull
                           MediaBrowserServiceCompat.Result<Bundle> result)

Called to request a custom action to this service. Primarily invoked with MediaBrowserCompat.sendCustomAction(String, Bundle, MediaBrowserCompat.CustomActionCallback).

Available actions:

• ACTION_ADD_DEVICE
• ACTION_GET_DEVICES
• ACTION_INIT_LIBRARY
• ACTION_LOAD_ITEM
• ACTION_REFRESH_DEVICES
• ACTION_REMOVE_DEVICE
• ACTION_SET_MIDI_IN
• ACTION_SET_MIDI_OUT
• ACTION_SET_MIDI_SPLIT

Standard Bundle fields sent upon encountering an error and calling result.sendError:

KEY	TYPE	VALUE
EXTRA_ERROR_REASON	String	The reason for the error
EXTRA_ERROR_INFORMATIONAL	boolean	If the error is informational and can safely be ignored
(Optional) EXTRA_EXCEPTION	Exception	Exception that is associated with how the error occurred

Overrides:

onCustomAction in class MediaBrowserServiceCompat

Parameters:

action - The custom action sent from the media browser

extras - The bundle of arguments sent from the media browser

result - The MediaBrowserServiceCompat.Result to send the result of the requested custom action

See Also:

MediaBrowserCompat.CUSTOM_ACTION_DOWNLOAD, MediaBrowserCompat.CUSTOM_ACTION_REMOVE_DOWNLOADED_FILE

getInputReceiver

public Receiver getInputReceiver()

Gets the Receiver that can be used to send MIDI messages to Moppy.

Returns:

the Receiver to send messages to

getReceiver

public Receiver getReceiver()

Gets the Receiver that messages are forwarded to.

Returns:

the Receiver or null if not set

See Also:

addReceiver(Receiver), removeReceiver(Receiver)

addReceiver

public boolean addReceiver(Receiver receiver)

Adds a Receiver to forward all MIDI messages to, regardless of if they originated on the MIDI wire input or the MIDI file input. See ReceiverDispatcher.add(Receiver) for more information.

Parameters:

receiver - the Receiver to add

Returns:

true if receiver was added, false if receiver was null or duplicate

See Also:

removeReceiver(Receiver)

removeReceiver

public boolean removeReceiver(Receiver receiver)

Removes a Receiver from the list to forward messages to.

Parameters:

receiver - the Receiver to remove

Returns:

true if receiver was removed, false if it was null or not added

See Also:

addReceiver(Receiver)

load

public boolean load(String mediaId,
                    boolean setToPlaying)

Loads a MidiLibrary.MidiFile by its media ID into Moppy. If loading is unsuccessful false will be returned. Under expected conditions the sequencer state will not be affected unless the load action is valid. The only event that may jeopardize the sequencer state is if and InvalidMidiDataException is thrown when calliing Sequencer.setSequence(Sequence) but is not thrown when calling MidiFileReader.getSequence(InputStream).

Parameters:

mediaId - the media ID of the song to load

setToPlaying - true if the song is to be immediately played, false if the sequencer is to load the song and pause

Returns:

false if there was an error loading, otherwise true (unless mediaId is invalid, it's likely a dev issue - check Logcat for details)