43 lines
1.5 KiB
Markdown
43 lines
1.5 KiB
Markdown
|
||
Channel3d 类控制应用程序中 在三维空间中播放的声音。每个声音均分配给一个声道，而且应用程序可以具有混合在一起的多个声道。
|
||
|
||
> 注：因为channel3d继承自channel，所以channel3d也包含channel的属性方法。
|
||
|
||
## 1、Channel3D属性
|
||
|
||
* `listener : egret3d.Vector3D` 返回监听者位置
|
||
* `maxDistance` 最大距离
|
||
* `minDistance` 最小距离
|
||
* `position` 三维空间中的位置
|
||
* `rollOffFactor rollOff` 系数
|
||
* `velocity` 传播方向
|
||
|
||
注意以上是Channel的属性，可以直接设置如下：
|
||
> `channel3d.maxDistance = 10;`
|
||
|
||
但是必须在初始化的时候设置，或者在play之前设置。通过对这些属性的设置，能够产生具有空间属性的声音效果。
|
||
|
||
## 2、Channel3D方法
|
||
|
||
* `Channel3d ( sound :egret3d.Sound, options :any )` 创建一个新的 Channel3d 对象，和channel构造方法一样
|
||
* `getDuration ( ):number` 音频持续时间
|
||
* `isPlaying ( ):boolean` 是否正在播放
|
||
|
||
## 3、代码示例
|
||
我们对channel的示例稍作修改
|
||
```
|
||
private _sound:egret3d.Sound;
|
||
// 加载声音文件成功
|
||
private loadSoundSuccess(e): void {
|
||
var channel3d:egret3d.Channel3d = new egret3d.Channel3d(e,{"volume":1,"loop":true});
|
||
|
||
channel3d.volume = 1;
|
||
channel3d.position = new egret3d.Vector3D(0,0,0);
|
||
channel3d.velocity = new egret3d.Vector3D(0,0,0);
|
||
channel3d.play();
|
||
|
||
}
|
||
|
||
```
|
||
使用`F5`调试即可播放。
|