uapmd-binding/dev.atsushieno.uapmd/AndroidAppModel

AndroidAppModel

Properties

open override var autoBufferSizeEnabled: Boolean

open override val blocklist: List<BlocklistEntry>

AppModel's own blocklist — the list the Plugin Selector shows. A standalone ScanTool keeps a separate one. BlocklistEntry.timestamp in uapmd has no counterpart in uapmd_blocklist_entry_t, so it is not carried across.

historyState

open override val historyState: UndoState

Also reports busy while an asynchronous plug-in mutation is still capturing state, so shortcuts cannot race the capture.

isAudioEngineEnabled

open override val isAudioEngineEnabled: Boolean

Turning this off is not a plain stopAudio(): the model stops the transport, mutes the output, lets release/reverb tails drain inaudibly, then deactivates plugins on the main thread and resets processing state, so a restart cannot resume stale voices.

isScanning

open override val isScanning: Boolean

lastPluginScanError

open override val lastPluginScanError: String?

The last scanning error, or null.

masterTempoPoints

open override val masterTempoPoints: List<TempoPoint>

masterTimelineTrack

open override val masterTimelineTrack: TimelineTrack

masterTimeSignaturePoints

open override val masterTimeSignaturePoints: List<TimeSignaturePoint>

sampleRate

open override val sampleRate: Int

sequencer

open override val sequencer: RealtimeSequencer

Owned by the model; do not close.

slowScanProgress

open override val slowScanProgress: SlowScanProgress

Progress of the slow scan. isScanning alone cannot tell a long scan from a stuck one, which is why uapmd-app's selector shows these.

timelineTrackCount

open override val timelineTrackCount: UInt

trackCount

open override val trackCount: UInt

transport

open override val transport: TransportController

Functions

addTrack

open override fun addTrack(callback: (Int, String?) -> Unit)

Asynchronous since uapmd 0.5.6: track mutations are undo engine operations.

addUmpEventToClip

open override fun addUmpEventToClip(trackIndex: Int, clipId: Int, tick: Long, words: UIntArray): Boolean

cancelPluginScanning

open override fun cancelPluginScanning()

clearPluginBlocklist

open override fun clearPluginBlocklist()

connectTrackGraph

open override fun connectTrackGraph(trackIndex: Int, connection: GraphConnection): OpResult

createEmptyMidiClip

open override fun createEmptyMidiClip(trackIndex: Int, positionSamples: Long, tickResolution: UInt, bpm: Double = 120.0): ClipAddResult

Creates an empty MIDI 2.0 clip; tickResolution is ticks per quarter.

createPluginInstance

open override fun createPluginInstance(format: String, pluginId: String, trackIndex: Int, config: PluginInstanceConfig = PluginInstanceConfig(), callback: (PluginInstanceResult) -> Unit)

Instantiates pluginId and attaches it to trackIndex; a negative index creates a new track. The callback runs once, on the thread that finishes instantiation.

disableUmpDevice

open override fun disableUmpDevice(instanceId: Int)

disconnectTrackGraphConnection

open override fun disconnectTrackGraphConnection(trackIndex: Int, connectionId: Long): OpResult

enableUmpDevice

open override fun enableUmpDevice(instanceId: Int, deviceName: String)

Registers the instance as a virtual MIDI 2.0 device where the platform supports it.

ensureTrackUsesEditorGraph

open override fun ensureTrackUsesEditorGraph(trackIndex: Int): Boolean

Switches the track from the simple linear chain to the editable graph.

generateScanReport

open override fun generateScanReport(): String

getClipAudioEvents

open override fun getClipAudioEvents(trackIndex: Int, clipId: Int): ClipAudioEventsResult

Reading counterpart to ProjectCommands.setClipMarkers/setClipAudioWarps.

getInstanceGroup

open override fun getInstanceGroup(instanceId: Int): UByte

getMidiClipUmpEvents

open override fun getMidiClipUmpEvents(trackIndex: Int, clipId: Int): UmpEventsResult

getTimelineState

open override fun getTimelineState(): TimelineState?

getTimelineTrack

open override fun getTimelineTrack(index: UInt): TimelineTrack

getTrackGraphConnections

open override fun getTrackGraphConnections(trackIndex: Int): GraphConnectionsResult

getTrackGraphNodes

open override fun getTrackGraphNodes(trackIndex: Int): GraphNodesResult

hidePluginUi

open override fun hidePluginUi(instanceId: Int)

importMidiTracksFromFile

open override fun importMidiTracksFromFile(filepath: String, callback: (Boolean, String?, Int) -> Unit)

Imports a possibly multi-track SMF, one new track per SMF track. callback receives success, an error when it failed, and how many tracks were created.

loadProject

open override fun loadProject(filePath: String): AppProjectResult

loadProjectFromHandleToken

open override fun loadProjectFromHandleToken(token: String): AppProjectResult

Android's document-picker path: resolves a content:// handle token.

notifyPersistentStorageReady

open override fun notifyPersistentStorageReady()

notifyUiReady

open override fun notifyUiReady()

Startup lifecycle; uapmd-app calls both once the UI exists.

performPluginScanning

open override fun performPluginScanning(forceRescan: Boolean = false, mode: ScanMode = ScanMode.InProcess, remoteTimeoutSeconds: Double = 20.0, requireFastScanning: Boolean = false)

Runs asynchronously; watch isScanning. ScanMode.Remote launches a separate scanner process on desktop and is unavailable on WebAssembly.

redo

open override fun redo(callback: (String?) -> Unit? = null)

refreshMasterTempoMap

open override fun refreshMasterTempoMap(): Double

Master-track tempo map. getTimelineState().tempo is a single value and cannot describe a project whose tempo changes; a beats view needs these. Rebuild once with refreshMasterTempoMap, then read the lists — they stay valid until the next refresh.

removeAllTracks