SimpleAudioEngine即可满足大部分需求，如果需要更进一步的功能，可以使用AudioEngine。

一、加载

  2. // 预加载
  3. static void preload(const std::string& filePath);
  4. static void preload(const std::string& filePath, std::function<void(bool isSuccess)> callback);

二、播放/停止

  2. // Play 2d sound
  3. // 返回audio ID，唯一识别audio instance，
  4. // AudioEngine::INVALID_AUDIO_ID:    表示无效的audio id
  5. static int play2d(const std::string& filePath,     // 可以是相对路径
  6.                   bool loop = false,             // 是否重复播放
  7.                   float volume = 1.0f,             // 音量：0.0 ~ 1.0
  8.                   const AudioProfile *profile = nullptr);    // nullptr表示default profile
  10. // audioID将失效，仍占据缓存
  11. static void stop(int audioID);        // 停止audioID的audio instance音效
  12. static void stopAll();                // Stop all audio instances.
  14. // audioID将失效，缓存也将清除
  15. static void uncache(const std::string& filePath);    // 清除音频缓存，会stop related audio first.
  16. static void uncacheAll();    // Uncache all audio data from internal buffer.

三、暂停/恢复

  2. static void pause(int audioID);        // Pause an audio instance
  3. static void pauseAll();                // Pause all playing audio instances.
  5. static void resume(int audioID);    // Resume an audio instance
  6. static void resumeAll();            // Resume all suspended audio instances.

四、设置状态

  2. // Sets volume for an audio instance
  3. // volume:    音量，0.0 ~ 1.0
  4. static void setVolume(int audioID, float volume);
  5. static float getVolume(int audioID);
  7. // Sets whether an audio instance loop or not.
  8. static void setLoop(int audioID, bool loop);
  9. static bool isLoop(int audioID);
  11. // 设置播放进度到第sec秒。
  12. static bool setCurrentTime(int audioID, float sec);
  13. static float getCurrentTime(int audioID);
  15. // 正在播放的将停止，后续的'preload', 'play2d' methods都将无效
  16. static void setEnabled(bool isEnabled);
  18. // 设置播放结束回调
  19. static void setFinishCallback(int audioID, const std::function<void(int,const std::string&)>& callback);
  21. // 设置可以同时存在的maxInstances个audio instance
  22. static bool setMaxAudioInstance(int maxInstances);
  23. static int getMaxAudioInstance();

五、获取状态

  2. static float getCurrentTime(int audioID);    // 获取当前播放进度，第几秒
  4. static float getDuration(int audioID);        // 获取音频总时长
  6. // 获取audio instance的状态。
  7. //         ERROR
  8. //         INITIALIZING,
  9. //         PLAYING,
  10. //         PAUSED
  11. static AudioState getState(int audioID);
  13. static int getMaxAudioInstance();    // 最大支持同时存在的audio instance数量
  15. static AudioProfile* getProfile(int audioID);
  16. static AudioProfile* getProfile(const std::string &profileName);
  18. static int getPlayingAudioCount();    // 正在播放的数量