第一篇把SpatialScene的三个声源固定在世界坐标中：钢琴S1(-2,0,3)、雨声S2(2,0,4)、提示音S3(0,1,2)，监听点位于原点。那一篇计算出的-33.69°、26.57°和0°是世界水平方位。真正加入听者转向后，这三个值不应该跟着变化，否则应用就在移动声源，而不是改变观察方向。我这次新增的是头部姿态时间线和相对方位输出，让连续转头时方向变化稳定、过期姿态不会倒灌到页面状态。

界面上设置一条0至300毫秒的方向轨迹：起点朝向0°，终点朝向30°，中间150毫秒对应15°。在150毫秒处，钢琴相对方向约-48.69°，雨声约11.57°，提示音为-15°。这些数值完全来自上一章的世界角减去当前头部朝向，而不是更改声源原始坐标。这里以用户操作的角度轨迹作为输入，先把数据处理管线建立起来；以后接入合适的姿态来源，仍可沿用同一个入口。

一、时间戳与旋转方向要同时约定

这一章只处理水平偏航角yaw，俯仰pitch和翻滚roll预留在结构中，不提前把三维旋转简化成三个角度相加。采用与上一章同一坐标定义：Y轴向上、Z轴向前、X轴向右；从上向下观察，头部从正前转向右侧时yaw增加。相对方位定义为worldAzimuth减去headYaw。这个减法看起来简单，却直接决定移动声源图标的方向：头向右转，世界里静止的雨声会向头部左边移动。

时间戳采用同一条轨迹内部的单调毫秒序列。把墙上时钟与播放进度混用容易遇到时间回拨；把毫秒误当作秒则会使插值系数长时间落在0附近。输入契约因此包括timeMs、yawDeg、pitchDeg和rollDeg，时间必须有限并递增，旋转角也必须是有限数字。显示页面可以只关注yaw，但模型不应丢掉其他两个字段，否则将来迁移到完整姿态时只能重写存档结构。

export interface HeadPose {
  timeMs: number;
  yawDeg: number;
  pitchDeg: number;
  rollDeg: number;
}

export function wrapAngle(angle: number): number {
  if (!Number.isFinite(angle)) throw new Error('INVALID_ANGLE');
  return ((angle + 180) % 360 + 360) % 360 - 180;
}

export function relativeAzimuth(worldDeg: number, headYawDeg: number): number {
  return wrapAngle(worldDeg - headYawDeg);
}

wrapAngle把结果放进[-180°,180°)，也是后续处理角度差的统一入口。比如头部从179°转向-179°，直觉上只转了2°，如果直接做普通线性插值，会得到358°的长路。这不是方位算式精度问题，而是圆周角度表达的拓扑特征。所有处理头部朝向的函数必须遵守相同归一化，否则界面可能在跨越后方角度时突然转满一圈。

二、角度插值必须选最短弧

我使用两帧之间的最短弧插值：先计算wrapAngle(next.yawDeg-prev.yawDeg)，再用夹在0到1之间的比例进行更新。两帧时间相同或逆序直接拒绝，而不是让分母为零或者把负时间比例继续用于画面。目标时刻小于起点取起点值，大于终点取终点值，边界采取固定帧策略；不允许没有界限地外推到未来几秒。

import { HeadPose, wrapAngle } from '../model/HeadPose';

export function interpolateYaw(a: HeadPose, b: HeadPose, atMs: number): number {
  if (![a.timeMs, b.timeMs, atMs].every((n: number) => Number.isFinite(n))) {
    throw new Error('INVALID_TIME');
  }
  if (b.timeMs <= a.timeMs) throw new Error('TIME_ORDER');
  if (!Number.isFinite(a.yawDeg) || !Number.isFinite(b.yawDeg)) {
    throw new Error('INVALID_YAW');
  }
  const ratio = Math.max(0, Math.min(1, (atMs - a.timeMs) / (b.timeMs - a.timeMs)));
  const delta = wrapAngle(b.yawDeg - a.yawDeg);
  return wrapAngle(a.yawDeg + delta * ratio);
}

export const START: HeadPose = { timeMs: 0, yawDeg: 0, pitchDeg: 0, rollDeg: 0 };
export const END: HeadPose = { timeMs: 300, yawDeg: 30, pitchDeg: 0, rollDeg: 0 };

把150毫秒代入这段函数得到15°。即使界面更新间隔不是均匀的，角度也依据实际目标时刻计算，而不依赖“每次增加5度”之类的帧数假设。对于角度刚好相差180°的两点，顺时针和逆时针同样短；这里wrapAngle将+180°记作-180°，作为统一决策。这个选择应该进入接口契约与用例，不要让不同模块各选一条方向，产生视觉和音频状态的分歧。

三、用递增序列守住最新姿态

时间线除了插值，还要挡住乱序事件。假设页面已经接纳150毫秒姿态，随后某个异步数据处理结果带着120毫秒到达，如果仍然刷新相对方位，钢琴会短暂回到较靠右的位置，然后又跳回150毫秒的结果。这类跳动不需要高频数据才能出现：普通列表异步回调、页面恢复时重新回放缓存，都可能造成时间顺序错位。

我让最新接受时间只向前增长，插值时使用明确的包围帧。重复的时间戳也拒绝进入状态，避免同一时间两帧内容不同导致结果不稳定。会话切换后需要重建一个新的HeadPoseTimeline实例，不能简单把lastAcceptedTime清零后继续处理上一条会话的延迟结果；后者还要结合会话代次共同过滤。这个代次策略会在后续播放会话章节继续展开。

import { HeadPose } from '../model/HeadPose';
import { interpolateYaw } from './HeadInterpolation';
import { SceneStore } from './SceneStore';
import { relativeAzimuth } from '../model/HeadPose';

export class HeadPoseTimeline {
  private lastAcceptedMs: number = -1;
  private left: HeadPose = { timeMs: 0, yawDeg: 0, pitchDeg: 0, rollDeg: 0 };
  private right: HeadPose = { timeMs: 300, yawDeg: 30, pitchDeg: 0, rollDeg: 0 };

  accept(frame: HeadPose): boolean {
    if (!Number.isFinite(frame.timeMs) || !Number.isFinite(frame.yawDeg)) return false;
    if (frame.timeMs <= this.lastAcceptedMs) return false;
    this.lastAcceptedMs = frame.timeMs;
    return true;
  }

  relativeAt(atMs: number, store: SceneStore): number[] {
    const yaw = interpolateYaw(this.left, this.right, atMs);
    return store.listViews().map((v) => relativeAzimuth(v.bearing.azimuthDeg, yaw));
  }

  close(): void { this.lastAcceptedMs = Number.POSITIVE_INFINITY; }
}

这里保持原有SceneStore作为场景位置的唯一来源，HeadPoseTimeline只负责姿态和相对角度。真正的页面实现还应区分“收到姿态帧”和“读取目标时刻”两种操作：前者推进最新接受时间，后者可以在合法区间内重复计算值，不应因为用户拖动进度条就将历史时间当成新的姿态事件。close将实例置为不可再接收的状态，下一条会话新建对象更直接，能避免残留回调继续污染页面。

四、界面如何解释连续变化

世界坐标仍保持第一章的数据。钢琴世界方位-33.69°，在0°头部朝向时相对方位仍是-33.69°，到15°时成为-48.69°，到30°时成为-63.69°。雨声从26.57°逐步过渡到11.57°和-3.43°，提示音从0°过渡到-15°和-30°。因此图中某个声源跨越零度是正常现象，并不意味着声源穿越听者或距离改变。

声音距离依然由上一章的三维差向量决定；当前算法只改变相对角度，没有引入随方位变化的实际音频渲染参数。用户旋转头部的交互与音频空间化设备能力需要在播放适配层连接，本文的数据处理函数是可复用的几何与时间运算，不把业务函数名称写成不存在的系统接口。官方AudioManager提供getSpatializationManager()入口，参考资料列有API起始版本和系统能力，后续播放链路应独立处理适配与路由条件。

相关官方文档原始地址：

https://developer.huawei.com/consumer/cn/doc/doccenter-references/api/arkts-apis-audio-audiomanager

https://developer.huawei.com/consumer/cn/features/spatialization

五、从固定轨迹看异常与状态恢复

检查顺序建议从角度原点、时间戳和相对方位三组数据入手。先确认三个世界方位与上一章完全一致，再确认0、150、300毫秒的头部朝向分别为0°、15°、30°，最后比较三枚声源的相对方向是否等于世界角减头部角。界面中显示-48.69°是保留两位小数后的格式化值；内部计算使用未提前四舍五入的浮点角度，避免经过多帧后持续累积舍入误差。

对于120毫秒的迟到事件，页面应保留已经接受的150毫秒状态；对于无效角度、NaN时间或逆序插值区间，直接返回错误或拒绝该帧，不以零度替代失效数据。对于页面离开，取消订阅并关闭时间线，避免事件处理对象长时间被引用。再次进入页面时从新会话的起始姿态建立轨迹，同时继续读取SpatialScene的原声源位置。这些规则可以作为下一篇播放会话与配置状态机的输入条件。

这一章真正新增的是独立的姿态时间线，而不是再造一套声源列表。几何模型给出了静态方位，最短弧插值给出了时间连续性，递增时间戳守住了状态更新顺序。接下来把这两类数据交给播放会话管理时，应继续分离场景事实、听者朝向和实际音频输出配置，才能在暂停、恢复及设备路由变化时保持同一组声源的语义。