VIBRANIAM

SAMPLER

用户手册

Oboe · Low latency · 16 pads · Android

草稿 — 截图待添加

VIBRANIAM Sampler — 用户手册（草稿 v0.1，简体中文）

0. 开始之前

0.1 安全与听力保护

• 一开始请将音量调低。低音很重的节奏型和 DRIVE 可能非常响。
• 连接耳机时，应用会显示监听提示。演奏前请先降低音量。
• 扬声器靠近时，麦克风（SAMPLE）可能产生啸叫。采样时请使用耳机。

0.2 系统要求

• Android 8.0（API 26）或更高版本。
• 44.1 kHz 立体声输出。有线耳机或 USB 音频设备延迟最低。
• 可选：USB 或蓝牙 LE MIDI 键盘。

0.3 权限

本应用没有联网权限，也不收集任何数据。

0.4 试用与解锁

应用可免费试用。每次使用允许 10 分钟的有效操作时间。剩余时间以 DEMO m:ss 显示在顶栏；结束前一分钟会出现提示。试用结束时会出现 DEMO TERMINATA 界面。点击 SBLOCCA（价格由 Google Play 显示）进行一次性购买；如已购买，点击 RIPRISTINA ACQUISTI。退出前请使用 SALVA LA SONG 以免丢失内容。[R7：按钮文字的语言可能变化]

1. 概述

基于 Oboe 构建 — 极低延迟。 整个音频引擎使用原生 C++ 编写，基于 Google 的 Oboe 库（AAudio 低延迟通道，请求 Exclusive 独占模式，44.1 kHz 浮点立体声）。音频回调不分配内存、不加锁、不写日志，因此你一触碰打击垫，它就立即响应。实际延迟取决于设备和输出；AUDIO OUTPUT 面板（第 10 节）会显示你手机上的实测数值。

VIBRANIAM Sampler 是一款拥有 16 个打击垫的采样器和步进音序器，采用原生低延迟音频引擎（Oboe，C++）。主要功能：

• 16 个打击垫：8 个鼓垫（1–8）和 8 个音高垫（9–16）
• 16 步音序器，512 个节奏型（pattern）和 512 个槽位的歌曲链
• 13 种内置合成乐器，以及你自己的采样
• 悬浮 2 个八度键盘，带弯音轮和调制轮，支持 MIDI 输入
• 每个打击垫独立的通道效果、全局效果机架、16 通道调音台
• 导出 WAV、FLAC、M4A（总混音或 16 个分轨）和 MIDI；可导入 MIDI 和音频文件

1.1 界面布局

2. 快速上手（5 步）

1. 点击一个打击垫即可发声。1–8 号是鼓声，9–16 号带音高。
2. 按 PLAY 启动音序器；按 RANDOM BEAT 立刻生成律动。
3. 点击音序器网格中的格子来开启或关闭步进。
4. 长按打击垫选中它，然后用 SAMPLE 录音，或用 IMPORTA 载入文件。
5. 用 SAVE 保存歌曲，并用导出面板渲染音频。

3. 打击垫

3.1 演奏与选择

• 点击 = 播放该打击垫。
• 长按 = 选中该打击垫（作为 SAMPLE、IMPORTA、CHANNEL FX 和键盘的目标）。
• 在 9–16 号打击垫上，点击 ▲ 区域或向上滑动可打开音符网格；▼ 表示该垫的网格已打开。
• 每个打击垫有自己的颜色；选中的打击垫更亮，边框更粗。

3.2 鼓垫（1–8）

每个步进只有开或关。打击垫下方的网格显示 16 个打击垫在 16 个步进上的状态。

3.3 音高垫（9–16）与音符网格

• 16 步 × 16 行窗口，覆盖 48 行范围（4 个八度）。
• OTTAVA SU / GIÙ 将窗口移动一个八度。窗口之外的音符仍会保存、继续播放，并包含在 MIDI 导出中。
• 各行显示真实音名（基准音 + 移调）；黑键颜色更深。
• 复音：同一步进可放多个音符。
• GLIDE 开/关，配合 TIME 设置音符之间的滑音。

4. 音序器、节奏型与歌曲

4.1 步进音序器

• SEQUENCER — 16 STEPS × 16 PADS。青色播放头显示当前步进。网格上方的数字标记步进分组。
• 点击格子即可切换开关。

4.2 Transport（走带）

• PLAY / STOP。− / + 以 2 BPM 为单位调整速度。
• RANDOM BEAT 为当前节奏型生成鼓点。

4.3 节奏型（512 个）

• PATTERN n/512：当前正在编辑的节奏型。使用 ◀ ▶（±1）和 −10 / +10，或点击数字直接输入（VAI AL PATTERN）。
• PLAYING m 显示引擎正在播放的节奏型。
• CLEAR Pn 清空正在编辑的节奏型。

4.4 歌曲链（512 个槽位）

• SONG: ON/OFF 在单个节奏型循环与按歌曲链播放之间切换。
• + Pn 追加当前节奏型；点击槽位增加重复次数（P3×4）；长按移除；CLR 清空歌曲链。

5. 声音

5.1 你自己的采样

• SAMPLE 通过麦克风录入所选打击垫。请使用耳机以避免啸叫。
• IMPORTA 载入 WAV、MP3、OGG 或 M4A。每个打击垫最长 6 秒；更长的文件会被截断并显示提示。
• 波形面板显示 CAMPIONE PAD n、名称和时长。

5.2 SUONO（内置乐器）

音高垫（9–16）可使用 13 种内置乐器。它们由应用合成，而非录音：是可辨认的乐器类别，并非采样级的真实感。

导出 MIDI 时会为每种乐器写入对应的 General MIDI 音色编号；导入 MIDI 文件时会选择最接近的乐器。

5.3 PRESET 界面

从底栏打开。预设以 3 列方块显示，带波形预览。点击试听；IMPORTA 将预设载入所选打击垫。分类定义在 presets.json 中；VIBRANIAM 分类保留给未来的音色包。

6. 键盘与 MIDI

6.1 悬浮键盘

• 通过可移动的键盘按钮打开；可将按钮拖到任意位置。
• 打击垫选择器 1–16 决定你演奏哪个打击垫。
• 2 个八度；八度切换。
• BEND 与 MOD 轮位于琴键上方左侧。
• HIDE CONTROL / SHOW CONTROL 折叠控件以腾出空间。

6.2 MIDI 输入

连接 USB（OTG）或蓝牙 LE MIDI 设备。支持：音符、弯音、CC1（调制轮）、CC64（延音）。

7. 塑造声音

7.1 CHANNEL FX（每个打击垫）

选中打击垫后可调整：

7.2 FX RACK（全局）

同类控件，作用于整个混音，另有 VOL（总音量）。

7.3 CHORD MATRIX — 和声移调

圆形排列的 12 个音名用于设定根音（0 到 +11 个半音）。音程按钮：UNI、OCT+、OCT−、5TH、4TH、MAJ3、MIN3、MIN6、ROOT。中心显示当前精确的移调半音数。

7.4 MIXER — 16 通道

每个打击垫一个推子。MUTE ALL 使所有通道静音，ALL 恢复。

8. 工程与文件

8.1 SAVE / LOAD

保存和载入整首歌曲（节奏型、歌曲链、声音、设置）。SAVE PRESET / LOAD PRESET 保存单个声音设置。

8.2 GLOBAL REC

在你演奏时捕获最终混音。录制期间横幅 ● GLOBAL REC — CAPTURING MIX 会闪烁；按 REC ● STOP 结束。

8.3 导出

选择格式、总混音或分轨以及小节数，然后导出。文件保存在 Music/Vibraniam。MIDI 可直接分享。

8.4 导入 MIDI

IMPORTA MIDI 将 .mid 文件读入节奏型。对话框会显示小节数、BPM 和任何警告；若当前歌曲未保存，可确认是否替换。

9. 外观

PAL 循环切换四种配色：1 原始、2 柔和、3 白色、4 黑白。

10. 音频性能

AUDIO OUTPUT 和 STRESS TEST 面板显示输出延迟、共享模式（Exclusive/Shared）、MMAP、burst/buffer 和采样率。延迟取决于设备和输出：有线或 USB 效果最好，蓝牙会增加延迟。引擎在音频回调中不进行内存分配，也不加锁。

11. 故障排除

12. 规格

• 音频引擎：基于 Oboe 1.8 的原生 C++（AAudio，低延迟，请求 Exclusive），实时安全回调
• 打击垫：16 · 步进：16 · 节奏型：512 · 歌曲槽位：512
• 采样上限：每个打击垫 6 秒 · 采样率：44.1 kHz 浮点立体声
• 导出：WAV、FLAC、M4A、MIDI（SMF1，480 PPQ）
• Android 8.0+ · ABI：arm64-v8a、armeabi-v7a、x86_64

13. 术语表

14. 链接