greenfoot
Class GreenfootSound

java.lang.Object
  greenfoot.GreenfootSound

public class GreenfootSound
extends java.lang.Object

GreenfootSound是Greenfoot系统中能够被播放的声音片段。每个GreenfootSound都会从一个声音文件载入音频。单个GreenfootSound不能同时异步播放，但是可以播放多次。

支持绝大多数AIFF、AU、WAV、MP3和MIDI各式的音频文件。

版本：

2.4

作者：

Poul Henriksen

译者：

Eric Pan（Upupzealot）

翻译有误请联系：hzxjhspxn@163.com

Constructor Summary

GreenfootSound(java.lang.String filename)
根据指定的音频文件创建GreenfootSound。

Method Summary

int	getVolume() 获得这个音频当前的播放音量，取值在0（静音）~100（最响）之间。
boolean	isPlaying() 若这个音频正在被播放，则返回true。
void	pause() 若音频正处于播放状态，暂停播放这个音频。
void	play() 开始播放这个音频。
void	playLoop() 开始循环播这个音频。
void	setVolume(int level) 设置这个音频的播放音量，在0（静音）~100（最响）之间取值。
void	stop() 停止播放这个音频。
java.lang.String	toString() 返回一个含本音频所加载的文件名、是否正被播放等信息的文本。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

GreenfootSound

public GreenfootSound(java.lang.String filename)

根据指定的音频文件创建GreenfootSound。

参数：

filename - 通常是工程目录下sounds目录中某音频文件的文件名（译者注：应包含后缀，后缀区分大小写。)

Method Detail

play

public void play()

开始播放这个音频。 若原本就已处在播放状态，则什么也不会发生。 若原本处于循环状态，则它会播放完这一遍，进而停止。 若原本处于暂停的状态，则它会从被暂停的位置恢复播放。 声音只会被播放一次。

playLoop

public void playLoop()

开始循环播这个音频。 若原本就已处在循环状态，则什么也不会发生。 若原本处于播放状态，则它会改为循环播放。 若原本处于暂停的状态，则它会从被暂停的位置恢复循环。

stop

public void stop()

停止播放这个音频。 若之后该音频再次被播放，则它会从整段声音的最开头开始播放。 若原本处于暂停的状态，那它亦会被停止。

pause

public void pause()

若音频正处于播放状态，暂停播放这个音频。 若之后该音频再次被播放，则它会从暂停的位置恢复播放。

务必确定你真的需要使用这个方法而不是stop()方法。条件允许的话，请尽量调用stop()方法，以释放GreenfootSound所占用的资源。暂停状态下的GreenfootSound所占用的资源并不会被释放。

See Also:

stop()

isPlaying

public boolean isPlaying()

若这个音频正在被播放，则返回true。

getVolume

public int getVolume()

获得这个音频当前的播放音量，取值在0（静音）~100（最响）之间。

setVolume

public void setVolume(int level)

设置这个音频的播放音量，在0（静音）~100（最响）之间取值。

参数：

level - 欲设置的音量大小

toString

public java.lang.String toString()

返回一个含本音频所加载的文件名、是否正被播放等信息的文本。

Overrides:

toString in class java.lang.Object