函式名:openal_source_stop()
適用版本:PHP 5 >= 5.1.0, PECL openal >= 0.1.0
函式描述:停止一個音訊源的播放
用法: openal_source_stop ( resource $source ) : bool
引數:
- $source:音訊源的控制代碼,透過openal_source_create()函式建立
返回值: 如果成功停止了音訊源的播放,則返回true;否則返回false。
示例:
// 建立一個音訊源
$source = openal_source_create();
// 設定音訊源的引數
openal_source_set($source, AL_LOOPING, AL_FALSE); // 設定迴圈播放為關閉
openal_source_set($source, AL_GAIN, 0.8); // 設定音量為0.8
// 播放音訊源
openal_source_play($source);
// 停止音訊源的播放
openal_source_stop($source);
注意事項:
- 在呼叫openal_source_stop()函式之前,必須先呼叫openal_source_play()函式開始播放音訊源。
- 如果音訊源已經停止,再次呼叫openal_source_stop()函式不會產生任何效果。
- 使用openal_source_stop()函式停止音訊源的播放後,可以再次呼叫openal_source_play()函式重新開始播放。
- 在完成使用音訊源後,應呼叫openal_source_destroy()函式銷燬音訊源。