Android MIDI Library 使用指南

颜德崇

于 2024-08-25 09:56:36 发布

阅读量917

点赞数 14

本文链接：https://blog.csdn.net/gitblog_00195/article/details/141524915

版权

Android MIDI Library 使用指南

android-midi-lib项目地址:https://gitcode.com/gh_mirrors/an/android-midi-lib

1. 目录结构及介绍

此开源项目android-midi-lib位于GitHub，其目录结构精心组织，便于理解和扩展。以下是主要组成部分：

src/main/java/com/leff/midi
- 包含了核心Java类，用于实现MIDI文件的读取、操作和写入。
classpath, gitignore, project, LICENSE, README.md, code-format.xml, pom.xml
- classpath: 编译路径相关配置。
- gitignore: 忽略版本控制的文件列表。
- project: IDE特定的项目配置（可能是历史遗留或IDE辅助文件）。
- LICENSE: 许可协议，说明了软件使用的权利和限制。
- README.md: 项目简介和快速入门指导。
- code-format.xml: 代码格式化规则。
- pom.xml: Maven项目的构建配置文件，包含了依赖管理、编译设定等。
Example Usage部分不在实际文件夹中，但指示了如何读取和写入MIDI文件以及支持实时事件处理系统的“播放”功能。

2. 项目的启动文件介绍

虽然本项目侧重于库的内部逻辑而非传统意义上的“启动文件”，但从应用集成的角度看，重要的是了解如何开始使用这个库。一般而言，集成始于创建一个AppMidiManager实例，如示例代码所示：

class AppMidiManager(context: Context) {
    private external fun startWritingMidi(midiDevice: MidiDevice, portNumber: Int)
    
    // 初始化时通过JNI调用处理设备打开和数据发送
}

在Android上下文中，通过以下步骤与MIDI服务交互，这通常标志着应用“启动”对MIDI功能的使用：

val midiManager = context.getSystemService(Context.MIDI_SERVICE) as MidiManager
if (midiManager.getMidiDevices().isNotEmpty()) {
    midiManager.openDevice(
        midiManager.getMidiDevices()[0],
        object : MidiManager.OnDeviceOpenedListener {
            override fun onDeviceOpened(device: MidiDevice?) {
                startWritingMidi(device!!, 0)
            }
        },
        null
    )
}

这里，重点在于通过MidiManager获取并打开设备，准备数据传输。