From ba38d2d399362eb35a2effd24fea0e76642fc5a7 Mon Sep 17 00:00:00 2001
From: vocoder712 <100213316+vocoder712@users.noreply.github.com>
Date: Tue, 27 Oct 2026 17:45:02 +0800
Subject: [PATCH] =?UTF-8?q?feature:=20=E5=AE=9E=E7=8E=B0=E5=9B=9E=E6=94=BE?=
=?UTF-8?q?=E6=97=B6=E9=92=A2=E7=90=B4=E5=8D=B7=E5=B8=98=E7=BA=B5=E5=90=91?=
=?UTF-8?q?=E6=BB=9A=E5=8A=A8?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
OpenUtau.Core/Util/Preferences.cs | 3 +
OpenUtauMobile/Assets/Lang/Strings.en.resx | 15 +++
OpenUtauMobile/Assets/Lang/Strings.ja.resx | 15 +++
OpenUtauMobile/Assets/Lang/Strings.ru.resx | 15 +++
OpenUtauMobile/Assets/Lang/Strings.uk.resx | 15 +++
.../Assets/Lang/Strings.zh-Hans.resx | 15 +++
.../Editor/PianoRollPlaybackFollow.cs | 127 ++++++++++++++++++
.../ViewModels/PianoRollViewModel.cs | 17 ++-
.../ViewModels/SettingsViewModel.cs | 29 +++-
OpenUtauMobile/Views/SettingsView.axaml | 22 +++
10 files changed, 270 insertions(+), 3 deletions(-)
create mode 100644 OpenUtauMobile/Services/Editor/PianoRollPlaybackFollow.cs
diff --git a/OpenUtau.Core/Util/Preferences.cs b/OpenUtau.Core/Util/Preferences.cs
index cf4b04ef..3460b38b 100644
--- a/OpenUtau.Core/Util/Preferences.cs
+++ b/OpenUtau.Core/Util/Preferences.cs
@@ -367,6 +367,9 @@ public class SerializablePreferences {
public double PlaybackRefreshRate = 20.0;
+ /// 回放时钢琴卷帘纵向滚动:0 = 关闭,1 = 边界滚动,2 = 保持居中。
+ public int PlaybackVerticalScroll = 0;
+
///
/// Android 全屏模式:0 = 始终,1 = 仅编辑页,2 = 关闭。
///
diff --git a/OpenUtauMobile/Assets/Lang/Strings.en.resx b/OpenUtauMobile/Assets/Lang/Strings.en.resx
index f19b641e..7286bd59 100644
--- a/OpenUtauMobile/Assets/Lang/Strings.en.resx
+++ b/OpenUtauMobile/Assets/Lang/Strings.en.resx
@@ -237,6 +237,21 @@
⚠ Not loaded - Please select a valid SF2 file
+
+ Vertical Auto-Scroll During Playback
+
+
+ Follow the current note. Boundary mode smoothly moves an offscreen note 10% inside the nearest edge; center mode keeps the note in the middle.
+
+
+ Off
+
+
+ Scroll at boundaries
+
+
+ Keep centered
+
Auto-Scroll Behavior
diff --git a/OpenUtauMobile/Assets/Lang/Strings.ja.resx b/OpenUtauMobile/Assets/Lang/Strings.ja.resx
index cae11ec4..6678526b 100644
--- a/OpenUtauMobile/Assets/Lang/Strings.ja.resx
+++ b/OpenUtauMobile/Assets/Lang/Strings.ja.resx
@@ -237,6 +237,21 @@
⚠ 未読み込み - 有効な SF2 ファイルを選択してください
+
+ 再生中の縦方向自動スクロール
+
+
+ 再生中のノートを追従します。境界モードでは画面外のノートを対応する端から内側 10% の位置へ、中央モードでは画面中央へ滑らかに移動します。
+
+
+ オフ
+
+
+ 境界でスクロール
+
+
+ 中央を維持
+
自動スクロール動作
diff --git a/OpenUtauMobile/Assets/Lang/Strings.ru.resx b/OpenUtauMobile/Assets/Lang/Strings.ru.resx
index ff679fe1..ecee838a 100644
--- a/OpenUtauMobile/Assets/Lang/Strings.ru.resx
+++ b/OpenUtauMobile/Assets/Lang/Strings.ru.resx
@@ -178,6 +178,21 @@
⚠ Не загружено - выберите корректный файл SF2
+
+ Вертикальная прокрутка при воспроизведении
+
+
+ Следовать за текущей нотой. При выходе за границы нота плавно перемещается на 10% внутрь от соответствующего края; в режиме центра — в середину видимой области.
+
+
+ Выключено
+
+
+ Прокрутка у границ
+
+
+ Удерживать в центре
+
Поведение автопрокрутки
diff --git a/OpenUtauMobile/Assets/Lang/Strings.uk.resx b/OpenUtauMobile/Assets/Lang/Strings.uk.resx
index 5e01610c..f013de46 100644
--- a/OpenUtauMobile/Assets/Lang/Strings.uk.resx
+++ b/OpenUtauMobile/Assets/Lang/Strings.uk.resx
@@ -178,6 +178,21 @@
⚠ Не завантажено - виберіть коректний файл SF2
+
+ Вертикальне прокручування під час відтворення
+
+
+ Стежити за поточною нотою. Після виходу за межі нота плавно переміщується на 10% усередину від відповідного краю; у режимі центру — у середину видимої області.
+
+
+ Вимкнено
+
+
+ Прокручувати біля меж
+
+
+ Утримувати в центрі
+
Поведінка автопрокручування
diff --git a/OpenUtauMobile/Assets/Lang/Strings.zh-Hans.resx b/OpenUtauMobile/Assets/Lang/Strings.zh-Hans.resx
index 9efa6176..74376513 100644
--- a/OpenUtauMobile/Assets/Lang/Strings.zh-Hans.resx
+++ b/OpenUtauMobile/Assets/Lang/Strings.zh-Hans.resx
@@ -237,6 +237,21 @@
⚠ 未加载 - 请选择有效的 SF2 文件
+
+ 回放时自动纵向滚动
+
+
+ 跟随当前播放音符。边界模式在音符越界后平滑移至对应边缘内侧 10%;中心模式平滑移至视口中央。
+
+
+ 关闭
+
+
+ 在边界处滚动
+
+
+ 保持中心滚动
+
走带自动翻页行为
diff --git a/OpenUtauMobile/Services/Editor/PianoRollPlaybackFollow.cs b/OpenUtauMobile/Services/Editor/PianoRollPlaybackFollow.cs
new file mode 100644
index 00000000..9f100646
--- /dev/null
+++ b/OpenUtauMobile/Services/Editor/PianoRollPlaybackFollow.cs
@@ -0,0 +1,127 @@
+using System;
+using OpenUtau.Core.Ustx;
+
+namespace OpenUtauMobile.Services.Editor
+{
+ /// 根据当前回放音符平滑调整钢琴卷帘的纵向视口。
+ public sealed class PianoRollPlaybackFollow
+ {
+ private const double EdgeRatio = 0.1;
+ private const double StopEpsilonKeys = 0.01;
+ private const double LerpSharpness = 10;
+ private const double MaxStepViewportRatio = 0.35;
+ private UVoicePart? _part;
+ private UNote? _targetNote;
+ private int _mode;
+ private double _visibleKeys;
+ private double _target;
+ private bool _active;
+
+ /// 清除旧音符与未完成的滚动目标。
+ public void Reset()
+ {
+ _part = null;
+ _targetNote = null;
+ _active = false;
+ }
+
+ /// 按播放位置确定纵向滚动目标,并用指数趋近插值推进一次动画。
+ ///
+ /// 这不是固定时长的起终点补间:每次从当前偏移出发,移动剩余距离的一部分,越接近目标越慢。
+ /// 未触发单步限幅时,剩余距离按 exp(-10 * seconds) 衰减,时间常数为 0.1 秒。
+ /// 新音符触发滚动时只替换目标,下一步直接从当前偏移转向;不等待旧动画结束。
+ ///
+ /// 0 为关闭,1 为边界滚动,2 为保持中心;其他值按关闭处理。
+ /// 是否正在实际回放;停止或等待渲染时清除动画。
+ /// 用户是否正在操作;为真时清除动画并保留用户控制的偏移。
+ /// 钢琴卷帘当前编辑的人声分片。
+ /// 工程绝对播放 Tick,查找音符前转换为分片相对 Tick。
+ /// 当前视口顶部的纵向偏移,单位为半音,向下增大。
+ /// 扣除参数面板后可见的半音数量,可以包含小数。
+ /// 本次动画的时间步长;调用方当前传入配置刷新率的倒数,并非实测帧间隔。
+ /// 本次插值后的纵向偏移;未启动动画时返回原偏移。
+ public double Update(int mode, bool playing, bool inputActive, UVoicePart? part, int tick,
+ double offset, double visibleKeys, double seconds)
+ {
+ // 关闭、停止、用户操作或视口无效时,旧目标一并清除,后续不能继续执行过期动画。
+ if (mode is not (1 or 2) || !playing || inputActive || part == null
+ || !double.IsFinite(visibleKeys) || visibleKeys <= 0)
+ {
+ Reset();
+ return offset;
+ }
+
+ // 分片、模式或可见高度改变后,旧目标的依据已失效;本次从当前偏移重新判断目标。
+ if (_part != part || _mode != mode || _visibleKeys != visibleKeys)
+ {
+ Reset();
+ _part = part;
+ _mode = mode;
+ _visibleKeys = visibleKeys;
+ }
+
+ // 空位置不产生新目标,已有滚动继续完成,避免短休止截断动画。
+ UNote? note = FindPlayingNote(part, tick - part.position);
+ if (note != null)
+ {
+ // key 是音符中心在完整音域中从上向下的坐标;y 是其相对视口顶部的位置,均以半音计。
+ double key = ViewConstants.MaxTone - 0.5 - note.AdjustedTone;
+ double y = key - offset;
+ // 中心模式始终有目标;边界模式仅在音符上沿或下沿越界时触发,半个音符高度为 0.5。
+ if (mode == 2 || y - 0.5 < 0 || y + 0.5 > visibleKeys)
+ {
+ // 同一音符的动画保留原目标,回到视口内也继续完成。
+ // 新音符必须满足上面的触发条件才替换旧目标;在视口内不会打断边界模式的旧动画。
+ if (!_active || _targetNote != note)
+ {
+ // 音符中心目标为顶部 10%、底部内侧 10%(即顶部 90%),或中央 50%。
+ // 由 y = key - offset 反解目标偏移;接近音域两端时以合法滚动范围为准。
+ double ratio = mode == 2 ? 0.5 : y < visibleKeys * 0.5 ? EdgeRatio : 1 - EdgeRatio;
+ _target = Math.Clamp(key - visibleKeys * ratio, 0, Math.Max(0, ViewConstants.MaxTone - visibleKeys));
+ _targetNote = note;
+ _active = true;
+ }
+ }
+ }
+
+ // 没有待完成的目标则保持原位;有目标时,不依赖当前音符是否仍越界或是否进入休止。
+ if (!_active) return offset;
+ double delta = _target - offset;
+ // 指数趋近理论上不会精确到达目标,剩余距离不超过 0.01 半音时直接对齐并结束。
+ if (Math.Abs(delta) <= StopEpsilonKeys)
+ {
+ _active = false;
+ return _target;
+ }
+
+ // 每次取剩余距离的 alpha 比例:next = offset + (target - offset) * alpha。
+ // 默认 20 Hz 时 seconds = 0.05、alpha ≈ 0.393,即每次移动约 39.3% 的剩余距离。
+ // 负时间按零处理;改变时间步长会相应调整比例,未限幅时保持相同的指数衰减速度。
+ double alpha = 1 - Math.Exp(-LerpSharpness * Math.Max(0, seconds));
+ // 大跨度跳音时,单次位移最多为可见高度的 35%,避免一次更新跨越过大。
+ // 此限幅会延长大跨度滚动的收敛时间;它按更新次数生效,并非每秒速度上限。
+ double step = Math.Clamp(delta * alpha, -visibleKeys * MaxStepViewportRatio, visibleKeys * MaxStepViewportRatio);
+ double next = offset + step;
+ // 本次推进后再检查一次阈值,达到精度就立即落到目标,避免多等一次更新。
+ if (Math.Abs(_target - next) <= StopEpsilonKeys)
+ {
+ _active = false;
+ return _target;
+ }
+ return next;
+ }
+
+ /// 按音符集合顺序取覆盖当前 Tick 的首个有效音符,结束 Tick 属于下一段。
+ private static UNote? FindPlayingNote(UVoicePart part, int tick)
+ {
+ if (tick < 0 || tick >= part.Duration) return null;
+ foreach (UNote? note in part.notes)
+ {
+ if (note == null) continue;
+ if (note.position > tick) break;
+ if (!note.Error && tick < note.End) return note;
+ }
+ return null;
+ }
+ }
+}
diff --git a/OpenUtauMobile/ViewModels/PianoRollViewModel.cs b/OpenUtauMobile/ViewModels/PianoRollViewModel.cs
index cd349636..f3ef765a 100644
--- a/OpenUtauMobile/ViewModels/PianoRollViewModel.cs
+++ b/OpenUtauMobile/ViewModels/PianoRollViewModel.cs
@@ -376,6 +376,9 @@ private void RefreshExpressionSupport()
private double _noteAreaWidth;
private double _noteAreaHeight;
+ /// 扣除底部音素参数面板后,音符实际可见的高度。
+ private double VisibleNoteAreaHeight => Math.Max(0, _noteAreaHeight - (IsPhonemePanelVisible ? PhonemePanelHeight : 0));
+
// 视口动态上限缓存(仿 EditorViewModel)
private bool _maxOffsetsDirty = true;
private double _cachedMaxTickOffset;
@@ -413,9 +416,9 @@ private void EnsureMaxOffsets()
// 当 tone=0 时,y = (MaxTone - 1 - 0 - KeyOffset) * KeyHeight = screenHeight
// => KeyOffset = MaxTone - 1 - screenHeight / KeyHeight
double visibleKeys = 0;
- if (_noteAreaHeight > 0)
+ if (VisibleNoteAreaHeight > 0)
{
- visibleKeys = KeyHeight > 0 ? _noteAreaHeight / KeyHeight : 0;
+ visibleKeys = KeyHeight > 0 ? VisibleNoteAreaHeight / KeyHeight : 0;
}
_cachedMaxKeyOffset = Math.Max(0, ViewConstants.MaxTone - visibleKeys);
@@ -612,7 +615,9 @@ private async Task UpdatePortraitAsync()
public bool IsNoteSelected(UNote note) => _selectedNoteLookup.Contains(note);
private readonly PlaybackViewportFollow _playbackFollow = new();
+ private readonly PianoRollPlaybackFollow _verticalPlaybackFollow = new();
+ /// 同步权威播放状态,并在用户输入空闲时更新横向与纵向跟随。
public void SyncPlaybackState(int tick, bool isPlaying, bool isWaitingRender)
{
if (IsPresentationSuspended) return;
@@ -632,6 +637,10 @@ public void SyncPlaybackState(int tick, bool isPlaying, bool isWaitingRender)
// 移动端保留固定标记与居中跟随。
TickOffset = tick - PlayMarkerX / TickWidth;
}
+ KeyOffset = _verticalPlaybackFollow.Update(Preferences.Default.PlaybackVerticalScroll, isPlaying,
+ _viewportInputActive || _desktopOperation != DesktopOperation.None || _inputState != PianoRollInputState.Idle || _panMotion.IsRunning,
+ EditingVoicePart, tick, KeyOffset, KeyHeight > 0 ? VisibleNoteAreaHeight / KeyHeight : 0,
+ 1.0 / Math.Max(1, Preferences.Default.PlaybackRefreshRate));
ApplyViewportLimits();
}
@@ -645,6 +654,7 @@ public void SetPresentationSuspended(bool suspended)
IsPresentationSuspended = suspended;
if (suspended)
{
+ _verticalPlaybackFollow.Reset();
StopPreviewTone();
_panMotion.Cancel();
IsPlaying = false;
@@ -888,6 +898,7 @@ public PianoRollViewModel()
this.WhenAnyValue(x => x.EditingVoicePart)
.Subscribe(_ =>
{
+ _verticalPlaybackFollow.Reset();
if (_pitchStrokePart != EditingVoicePart) EndPitchStroke();
RebuildPianoRollContextActions();
this.RaisePropertyChanged(nameof(IsVoiceMode));
@@ -904,6 +915,8 @@ public PianoRollViewModel()
.Subscribe(_ =>
{
this.RaisePropertyChanged(nameof(IsPhonemePanelVisible));
+ InvalidateMaxOffsets();
+ ApplyViewportLimits();
})
.DisposeWith(_disposables);
diff --git a/OpenUtauMobile/ViewModels/SettingsViewModel.cs b/OpenUtauMobile/ViewModels/SettingsViewModel.cs
index 69c758a3..d9e785de 100644
--- a/OpenUtauMobile/ViewModels/SettingsViewModel.cs
+++ b/OpenUtauMobile/ViewModels/SettingsViewModel.cs
@@ -103,7 +103,7 @@ public StopButtonBehaviorOption(StopButtonBehavior value, string displayName)
}
}
-/// 走带自动翻页行为选项(用于绑定到选择器)。
+/// 回放自动滚动行为选项(用于绑定到选择器)。
public class AutoScrollBehaviorOption
{
public int Value { get; }
@@ -483,6 +483,19 @@ public class SettingsViewModel : NavigateViewModelBase, IDisposable
[Reactive]
public AutoScrollBehaviorOption? SelectedAutoScrollBehavior { get; set; }
+ /// 可选回放纵向滚动行为列表。
+ public IReadOnlyList AvailableVerticalScrollBehaviors { get; } =
+ new List
+ {
+ new(0, L.S("Settings.VerticalScroll.Disabled")),
+ new(1, L.S("Settings.VerticalScroll.Boundary")),
+ new(2, L.S("Settings.VerticalScroll.Center"))
+ };
+
+ /// 当前选中的回放纵向滚动行为。
+ [Reactive]
+ public AutoScrollBehaviorOption? SelectedVerticalScrollBehavior { get; set; }
+
// ── Edit & Behaviour: Stop Button ──────────────────────────────
/// List of available stop button actions.
public IReadOnlyList AvailableStopButtonBehaviors { get; } =
@@ -1015,6 +1028,20 @@ private void InitializePlaybackSettings()
})
.DisposeWith(_disposables);
+ int verticalScrollVal = Preferences.Default.PlaybackVerticalScroll;
+ SelectedVerticalScrollBehavior = AvailableVerticalScrollBehaviors.FirstOrDefault(b => b.Value == verticalScrollVal)
+ ?? AvailableVerticalScrollBehaviors[0];
+ this.WhenAnyValue(x => x.SelectedVerticalScrollBehavior)
+ .WhereNotNull()
+ .DistinctUntilChanged(option => option.Value)
+ .Skip(1)
+ .Subscribe(opt =>
+ {
+ Preferences.Default.PlaybackVerticalScroll = opt.Value;
+ Preferences.Save();
+ })
+ .DisposeWith(_disposables);
+
// Initializing Stop Button Behavior
int stopBehaviorVal = Preferences.Default.StopButtonBehavior;
StopButtonBehavior stopBehavior = stopBehaviorVal is >= 1 and <= 3
diff --git a/OpenUtauMobile/Views/SettingsView.axaml b/OpenUtauMobile/Views/SettingsView.axaml
index 04457da7..a6327055 100644
--- a/OpenUtauMobile/Views/SettingsView.axaml
+++ b/OpenUtauMobile/Views/SettingsView.axaml
@@ -512,6 +512,28 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+