3D定位

声像的位置控制方法支持“3D定位”。

• 根据收听者和声源信息设置对各扬声器的发送Level。
  
• 可以根据收听者和声源速度获得多谱勒效应。
  
• 可以将Player句柄作为声源处理。
  设置收听者的位置和速度等信息时，将自动计算发送Level和音高。
  
• 也支持用于存在多个视点情况的多个收听者 。
  
  
  
  
  
  

■收听者信息

1. 位置 (x, y, z)
   收听者的位置。
2. 速度 (x, y, z)
   收听者的移动速度。
3. 向前的姿势向量 (x, y, z)
   收听者面对的方向。
4. 向上的姿势向量 (x, y, z)
   收听者头顶的方向。
   

■声源信息

1. 位置 (x, y, z)
   声源的位置。
2. 速度 (x, y, z)
   声源的速度。
3. 声锥的方向 (x, y, z)
   产生声源声音的方向。
4. 声锥信息 (内部角度、外部角度、外部音量)
   表示声源的传播和环绕。
5. 最大距离、最小距离
   指定受距离衰减影响的距离范围。
   在最小距离内侧和最大距离外侧，不受距离衰减的影响。
   此外，在最小距离内侧，可以通过内部Panning获得逐渐穿过对面扬声器但不更改音量的效果。
6. 多谱勒增益
   为物理计算的多谱勒效应指定夸张演出所需的倍率 。
   
7. 自定义距离衰减AISAC
   通过应用距离衰减AISAC，可以设置该声音特定的距离衰减曲线。
8. 传播系数（※当前版本不支持）
   将单声道声音扩张为立体声声音的值。
   

关于多定位播放

3D定位可以根据多个声源参数实现“多重定位播放”。
通过为单个ExPlayer设置( ::criAtomExPlayer_Set3dSourceListHn )管理多个声源的声源列表( ::CriAtomEx3dSourceListHn )， 可以在定位和衰减等计算中使用添加到声源列表的所有声源参数。

基本操作如下。

1. 创建声源列表。( ::criAtomEx3dSourceList_Create )
2. 创建要添加到声源列表的多个声源。( ::criAtomEx3dSource_Create )
3. 根据需要为声源列表添加声源。( ::criAtomEx3dSourceList_Add )
4. 在ExPlayer设置声源列表。( ::criAtomExPlayer_Set3dSourceListHn )

此外，使用时应注意以下几点。

• 可以添加到声源列表的声源数量没有上限，但声源数量与处理负荷成正比。
• 如果在为ExPlayer设置声源列表的状态下，为ExPlayer设置声源，则从ExPlayer清除先前设置的声源列表，并将新设置的声源设置到ExPlayer。
• 已经设置到ExPlayer中且添加到声源列表的声源，将无法添加到另一个声源列表中。
• 距离的音频优先级衰减始终应用与收听者的距离最小的声源的设置值。
• 不会因多谱勒增益等更改音高。

关于多声道音频

3D定位还可以将多声道音频作为声源处理。
但是，它在保持原始扬声器结构的同时定位。
例如，如果是5.1ch音频，则保持L・R・C・LFE・Ls・Rs的结构和配置，无论将声源向哪里移动，都从各个频道播放。
此外，中置和LFE不受声源参数变化的任何影响。
与之相对，其他频道都将受到影响，并且当移动声源位置时，每个输出频道根据与收听者的关系发生变化。

收听者面向前方（前方向量(0.0, 0.0, 1.0)・上方向量(0.0, 1.0, 0.0)）时声源位置的输出目标列表（5.1ch）

收听者看到的声源位置	L的输出目标	R的输出目标	Ls的输出目标	Rs的输出目标
前方	L	R	Ls	Rs
右方	R	Rs	L	Ls
后方	Rs	Ls	R	L
左方	Ls	L	Rs	R

如果将声源配置在最小衰减距离以下，则将根据内部距离进行Panning。
关于内部距离请参照点击这里。
此外，如果虚拟扬声器功能启用时，则扬声器角度会由其设置决定。
关于虚拟扬声器请参照点击这里。