GalaxyBudsClient 本地化翻译解析：从 sk.md 缺失字符串看 Multipoint 解锁与 360 Audio 空间音频两大新功能

桌面应用智能硬件蓝牙【免费下载链接】GalaxyBudsClientUnofficial Galaxy Buds Manager for Windows, macOS, Linux, and Android项目地址https://gitcode.com/gh_mirrors/ga/GalaxyBudsClient点击查看免费下载导读本文以仓库自动生成的斯洛伐克语本地化进度报告 meta/sk.md 为骨架逐条拆解其中列出的 38 条缺失翻译字符串Missing strings并沿这些 UI 文案追根溯源到 GalaxyBudsClient 的真实源码实现settings_multipoint_*一组对应无需三星账户即可解锁耳塞多设备同时连接Multipoint的 MultipointPatcherspatial_*/page_spatial_audio一组对应 360 Audio 空间音频动态头部跟踪的 SpatialSensorManager 及其平台实现。读完本文你将清楚这些缺失字符串在界面上的准确含义、背后功能的工作原理与适用条件以及它们与i18n/en.axaml、i18n/sk.axaml和源生成器之间的联动关系。一、meta/sk.md 是什么本地化缺失字符串报告meta/sk.md是一份自动生成、自动更新的本地化状态文件文件头部明确标注This file is auto-generated and automatically updated. Do not modify this file manually.由 ThePBone/XamlTranslationValidator 工具驱动。它并不包含翻译内容本身而是报告斯洛伐克语Slovakia,sk语言包当前尚未翻译的字符串键清单当前进度93%剩余38 条缺失字符串每条记录给出「键名Key」与「原始英文字符串Original string」两列供翻译者对照填写。同类进度报告覆盖 ar、br、cn、cz、de、es、fa、fr、gr、hu、il、in、it、ja、ko、nl、pl、pt、ro、ru、sv、tr、tw、ua、vn 等全部语言汇总见 meta/translations.md。从中可以看到 93% 是一个常见档位cn、it、ru、sk、sv、tr、tw、vn 等语言均同为此进度。翻译的具体载体是仓库根目录下的 Avalonia XAML 资源文件例如 GalaxyBudsClient/i18n/sk.axaml而英文基准包 GalaxyBudsClient/i18n/en.axaml 中定义了这 38 条字符串的完整原文与键名。这 38 条缺失字符串按功能主题高度集中恰好分成两大块下文分别展开。二、第一组缺失字符串settings_multipoint_* —— 免三星账户解锁 Multipoint2.1 界面文案逐条对照sk.md中缺失的settings_multipoint_*共 7 条对应设置页中的「Multipoint」区块含义如下Key英文原文作用settings_multipoint_headerMultipoint区块标题settings_multipoint_autoUnlock multipoint without a Samsung account开关项免三星账户解锁 Multipointsettings_multipoint_auto_description详见下方说明开关的详细说明文字settings_multipoint_applyApply now「立即应用」按钮settings_multipoint_apply_descriptionWrite the marker again. Your earbuds will briefly disconnect and reconnect.手动重写标记的说明settings_multipoint_appliedMultipoint unlocked. Connect your phone to test it.操作成功提示settings_multipoint_failedCould not unlock multipoint. Make sure your earbuds are connected and try again.操作失败提示其中settings_multipoint_auto_description的原文信息量最大直接说明了功能机制Your earbuds normally drop your phone as soon as a non-Samsung device connects, unless the Galaxy Wearable app is signed in. Enabling this writes the missing version marker to your earbuds every time they connect, which lets both devices stay connected. The earbuds keep the marker only until they power down, so putting them back in the case clears it.翻译要点开启后每次耳塞连接时都会写入一个缺失的版本标记version marker使手机与非三星设备能够同时保持连接该标记仅存在于本次开机周期内耳塞放回充电盒断电即被清除因此无法一劳永逸必须在每次连接时重写。2.2 源码印证MultipointPatcher 的完整实现这条 UI 文案背后的核心逻辑全部落在 GalaxyBudsClient/Platform/MultipointPatcher.cs 中其类注释本身就是对文案的技术展开机制根因三星固件只允许第二台设备在asVer记录字段为 2 或 3 时保持音频链路否则一旦第二路音频连接建立第一台设备会以 reason0xA9被强制断开。asVer只能由 SMEP 通道上的MDE_VERSION处理器opcode0x0B写入。为什么非三星主机做不到PC / Mac 等非三星主机从不发送该消息所以从电脑连接会直接把手机踢下线同一消息携带的账户哈希account hash并不参与本次门控判定作者注明已在真机验证错误哈希与清零哈希均能保持手机连接而asVer0会立即断开因此只需写入仅含版本号的精简形式不影响账户字段。为什么需要“每次连接都写”保存asVer的对端记录位于耳塞RAM 而非 flash开机清空所有槽位且不写默认值重新填充记录时会从存储恢复账户字段、却直接从活动记录读取asVer。因此普通断开不会丢值放进充电盒断电即丢失任何帧序列都无法使其持久化——这就是“per-power-session write”而非一次性补丁的由来。写入的数据为 version-only 变体MDE_VERSION SET blob04 03 04 | 00 00 | 0B | 02 | | | | | -- asVer 2 | | | | ------- opcode 0x0B MDE_VERSION | | | -------------- reserved prefix | | -------------------- blob length (4) | ----------------------- TLV type 0x03 (blob) -------------------------- TLV tag 0x04它被封装进WRITE_PROPERTY0x43的UNK_SPP_ALT0x01SMEP 帧中最终编码为从 Galaxy 手机抓取并成功回放的完整帧FC 0B 00 01 43 04 03 04 00 00 0B 02 1E AF CC源码中对应的字节数组与常量包括MdeVersionAsVer2、MdeVersionOpcode 0x0B以及一组精心调校的时序参数SMEP 通道连接超时ConnectTimeoutMs 10000、首次连接重试ConnectAttempts 4耳塞 SPP4 服务器需要片刻才接受连接前期 RFCOMM 报错属预期、重试间隔ConnectRetryDelayMs 1500、会话稳定延时SettleDelayMs 3000、断开沉降DisconnectSettleMs 500、写入后监听验证窗口VerifyWindowMs 3000、自我重连抑制窗SelfReconnectSuppressMs 15000避免恢复会话时钩子立即自我触发形成死循环。ApplyAsync()是完整执行序列断开常规会话 → 切换备用模式SetAltMode(true)→ 建立 SMEP 通道 → 写入MDE_VERSION并回读校验WriteAndReadBackAsync→ 恢复常规会话。回读asVer为 2 或 3 判定成功若耳塞未返回状态帧写操作本身未失败也按成功处理仅记警告日志。IsSupportedByCurrentDevice则通过Features.Rename特性判断当前设备是否具备 SMEP 通道——只有支持重命名的机型才适用。设置开关由Settings.Data.AutoEnableMultipoint控制事件钩子挂在BluetoothImpl.Instance.Connected上在每次连接事件后延时等待会话稳定再执行。三、第二组缺失字符串page_spatial_audio / spatial_* —— 360 Audio 空间音频3.1 界面文案逐条对照sk.md中另一大块是「360 Audio」页面page_spatial_audio及其下属的spatial_*系列共 31 条覆盖头部跟踪开关、重定向前方、演示、广播、声场与系统级音频等多个功能点Key英文原文功能page_spatial_audio360 Audio页面标题spatial_audio_descDynamic head tracking and 360 spatial sound页面副标题spatial_enable/spatial_enable_descEnable Head Tracking / Activates internal motion sensors to track head orientation启用头部跟踪激活耳塞内置运动传感器spatial_recenter/spatial_recenter_descRecenter Heading / Resets front orientation to where you are currently looking重定向前方以当前注视方向为新的正前方spatial_demo_play/spatial_demo_stop/spatial_demo_descPlay / Stop 360 Audio Demo交互式空间提示音随头部转动在 3D 中移动演示模式spatial_broadcast_osc/spatial_broadcast_osc_descBroadcast via OSC (DAWs / Plugins)向 localhost:9000 实时发送 yaw/pitch/roll 与四元数OSC 广播面向 DAW / 插件spatial_broadcast_opentrack/spatial_broadcast_opentrack_descBroadcast to Games (OpenTrack)向 localhost:4242 发送 FreeTrack / OpenTrack UDP 包适用于飞行/驾驶模拟OpenTrack 游戏广播spatial_tracking_active/spatial_tracking_inactiveTracking active / Tracking stopped跟踪状态指示spatial_speaker_angle/spatial_speaker_angle_descVirtual Soundstage Width / Adjusts the stereo angle of the virtual front speakers虚拟声场宽度spatial_ambience/spatial_ambience_descRoom Ambience / Simulates studio acoustic reflections to externalize sound房间氛围模拟录音棚声学反射spatial_system_audio/spatial_system_audio_descSystem-Wide 360 Audio / Applies 360 head tracking to all system sound (Spotify, YouTube, movies, games)系统级 360 音频spatial_blackhole_status_ok/_restart_needed/_missingBlackHole 2ch virtual driver ready / installed, please restart CoreAudio / required on macOSBlackHole 2ch 虚拟驱动状态检测spatial_blackhole_missing_descTo capture macOS system audio for 360 spatialization, the free open-source BlackHole 2ch driver is required.macOS 采集系统音频的依赖说明spatial_blackhole_howtoSelect BlackHole 2ch as your macOS Sound Output, then turn on the switch abovemacOS 使用指引spatial_blackhole_installInstall BlackHole (Homebrew)通过 Homebrew 安装按钮spatial_blackhole_restartRestart CoreAudio (Activate Driver)重启 CoreAudio 激活驱动按钮spatial_open_audio_midi/spatial_open_sound_prefOpen Audio MIDI Setup / Open Sound Settings打开系统音频设置入口spatial_windows_info见下Windows 平台说明其中spatial_windows_info原文指出Windows 下通过WASAPI Loopback原生捕获系统音频无需任何第三方虚拟驱动头部跟踪数据可通过 OpenTrack端口 4242广播给 PC 游戏或通过 OSC端口 9000广播给 VRChat。3.2 源码印证SpatialSensorManager 与平台层上述文案所描述的空间音频能力由 GalaxyBudsClient/Message/SpatialSensorManager.cs 实现其类注释明确说明这是对三星客户端头部跟踪接收器的逆向工程实现实时收集佩戴者头部朝向的 4 维四元数quaternion事件驱动NewQuaternionReceived事件携带Quaternion订阅 SppMessageReceiver 的AnyMessageDecoded过滤SpatialAudioControlDecoder与SpatialAudioDataDecoder。头部跟踪开关Attach()先发送SET_SPATIAL_AUDIO置 1再发送SPATIAL_AUDIO_CONTROL的Attach指令随后启动 2 秒周期的 keep-alive 定时器Detach()反向执行并停止定时器。这对应文案中的spatial_enableEnable Head Tracking。数据解析SpatialAudioData.BudGrv事件携带的GrvFloatArray前四个浮点数被构造成System.Numerics.Quaternion对外发布——这正是spatial_broadcast_osc描述中 yaw, pitch, roll and quaternion 的数据来源。状态与演示AttachSuccess/DetachSuccess控制码对应用户可见的 Tracking active / Tracking stopped 状态切换演示功能、重定向前方、虚拟声场宽度、房间氛围等 UI 项则进一步依赖 GalaxyBudsClient/Platform/SpatialAudio 目录下的 13 个实现文件含 OSC/OpenTrack 广播、WASAPI/BlackHole 系统音频捕获等逻辑。平台差异也印证了文案设计Windows 走原生 WASAPI Loopback无需第三方驱动macOS 则需要开源虚拟声卡 BlackHole 2ch 才能捕获系统音频因此 UI 提供了安装Homebrew、重启 CoreAudio、打开 Audio MIDI Setup / 声音设置等一系列操作入口。四、翻译流水线从键名到 XAML 再到源生成器要正确翻译这 38 条字符串需要理解它们在整个项目中的流转方式英文基准GalaxyBudsClient/i18n/en.axaml 中sys:String条目以x:Key形式定义全部键名与原文例如 466–472 行即settings_multipoint_*七条747–777 行即spatial_*系列。语言文件各语言对应i18n/code.axaml例如斯洛伐克语 GalaxyBudsClient/i18n/sk.axaml。sk.md报告缺失键意味着sk.axaml中尚无这 38 个x:Key条目。编译期校验与绑定GalaxyBudsClient.Generators/Localization/LocalizationKeySourceGenerator.cs 是增量源生成器在编译期解析各语言 XAML 字典为每个键生成强类型访问代码确保 XAML 中的{Translate xxx}引用见 TranslateExtension能映射到对应语言的sys:String。缺失键在运行时回退英文原文这就是sk.md中每条缺失记录同时附上英文原文的原因。验证与报告meta/sk.md与 meta/translations.md 由 XamlTranslationValidator 周期性对比英文基准与各语言文件后生成属于 CI 流水线的产物因此头部声明请勿手工修改。给翻译者的实操建议编辑GalaxyBudsClient/i18n/sk.axaml为sk.md中列出的每个 Key 追加一条sys:String条目键名与英文基准完全一致值替换为斯洛伐克语译文保存后重新编译项目即可让源生成器纳入新键如无即时 CI 重新生成报告sk.md中的缺失清单会在下一次自动更新时同步消除。注意settings_multipoint_auto_description、spatial_windows_info这类长文案包含从句与专有名词如 WASAPI Loopback、BlackHole 2ch、OpenTrack、OSC、VRChat翻译时建议保留技术专名原样仅翻译叙述性部分以保证与源码注释、第三方软件名称的一致性。五、总结与延伸阅读meta/sk.md虽是一份看似机械的缺失字符串清单却是观察 GalaxyBudsClient 功能演进的绝佳窗口38 条缺失键中没有任何一处是零碎的历史文案而是整齐地勾勒出两个新上线的完整功能模块——免三星账户的 Multipoint 解锁7 条与 360 Audio 空间音频31 条。前者由 MultipointPatcher 通过 SMEP 通道写入MDE_VERSION (asVer2)实现后者由 SpatialSensorManager 与 Platform/SpatialAudio 平台实现共同支撑。对翻译者本文提供了逐键的语境对照对开发者这些字符串键名settings_multipoint_*、spatial_*就是深入上述源码的索引。如需进一步了解本地化全貌可查阅 meta/translations.md、英文基准 GalaxyBudsClient/i18n/en.axaml 以及多语言示例 GalaxyBudsClient/i18n/ko.axaml同档位 93% 语言包中已部分补齐这些键可作为翻译风格参考。赞分享桌面应用智能硬件蓝牙【免费下载链接】GalaxyBudsClientUnofficial Galaxy Buds Manager for Windows, macOS, Linux, and Android项目地址https://gitcode.com/gh_mirrors/ga/GalaxyBudsClient点击查看免费下载相关推荐GalaxyBudsClient 本地化翻译体系深度解析从 XamlTranslationValidator 缺失字符串报告到 Multipoint 与 360 Audio 功能实现GalaxyBudsClient 本地化翻译体系深度解析从 XamlTranslationValidator 缺失字符串报告到 Multipoint 与 36桌面应用智能硬件蓝牙GalaxyBudsClient 俄语本地化状态解析38 条待翻译字符串背后的 Multipoint 解锁与 360 音频功能GalaxyBudsClient 俄语本地化状态解析38 条待翻译字符串背后的 Multipoint 解锁与 360 音频功能 导读 meta/ru.md h桌面应用智能硬件蓝牙GalaxyBudsClient 多点连接解锁与 360 空间音频全解析从 meta/tr.md 翻译进度报告透视两大新功能GalaxyBudsClient 多点连接解锁与 360 空间音频全解析从 meta/tr.md 翻译进度报告透视两大新功能 本文以仓库中自动生成的土耳其语翻桌面应用智能硬件蓝牙上一篇GitHub中文界面体验让代码协作变得亲切自然下一篇GitHub汉化插件打破语言壁垒让全球开发者社区更亲近的界面本地化解决方案创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考