droid-mcp-playback/io.droidmcp.playback/PlaybackTools

PlaybackTools

Provider for the playback tools: GetNowPlayingTool and MediaControlTool.

Both tools read/control media sessions through the system, which requires Notification Listener access. The host app must register its listener ComponentName via NotificationListenerHolder and have the listener enabled in Settings; use permissionStatus to check and prompt for that access.

Functions

all

fun all(context: Context): List<McpTool>

Instantiates all playback tools bound to context.

hasPermissions

fun hasPermissions(context: Context): Boolean

Always true; there are no runtime permissions to check (see permissionStatus).

isNotificationListenerEnabled

fun isNotificationListenerEnabled(context: Context): Boolean

Returns whether the host's registered notification listener (from NotificationListenerHolder) is actually enabled in system Settings.

permissionStatus

fun permissionStatus(context: Context): PermissionStatus

Reports notification-listener access as a PermissionStatus; when not granted, carries an intent to the notification-access Settings screen.

requiredPermissions

fun requiredPermissions(): List<String>

No runtime permissions: Notification Listener access is a special access granted via Settings, not a runtime permission.

supportedTools

fun supportedTools(context: Context): Set<String>

The names of all playback tools provided by this module.