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 @@ + + + + + + + + + + + + + + + + +