The WAV Player API provides functions for playing the waveform audio file format(*.wav).

Required Header

#include <wav_player.h>

Overview

The WAV Player API allows you to simply play and stop a wav file. To play a certain wav file, call wav_player_start_new() with a path to the .wav file. When playing a wav file is finished, wav_player_playback_completed_cb() will be invoked.

Functions
int	wav_player_start_new (const char path, sound_stream_info_h stream_info, wav_player_playback_completed_cb callback, void user_data, int *id)
	Plays a WAV file with stream information of sound-manager.
int	wav_player_stop (int id)
	Stops playing the WAV file.
Typedefs
typedef void(*	wav_player_playback_completed_cb )(int id, void *user_data)
	Called when a WAV file has finished playing.

typedef void(* wav_player_playback_completed_cb)(int id, void *user_data)

Called when a WAV file has finished playing.

This callback is not invoked by calling wav_player_stop().

Parameters:

[in]	id	The completed wav player ID
[in]	user_data	The user data passed from the callback registration function

Enumeration of error codes for WAV player.

Enumerator:

WAV_PLAYER_ERROR_NONE	Successful
WAV_PLAYER_ERROR_INVALID_PARAMETER	Invalid parameter
WAV_PLAYER_ERROR_INVALID_OPERATION	Invalid operation
WAV_PLAYER_ERROR_FORMAT_NOT_SUPPORTED	Format not supported
WAV_PLAYER_ERROR_NOT_SUPPORTED_TYPE	Not supported (Since 3.0)

int wav_player_start_new	(	const char *	path,
		sound_stream_info_h	stream_info,
		wav_player_playback_completed_cb	callback,
		void *	user_data,
		int *	id
	)

Plays a WAV file with stream information of sound-manager.

Remarks:: Voice Recognition and VOIP stream types are not supported in this API.

Parameters:

[in]	path	The file path to play
[in]	stream_info	The sound stream information handle
[in]	callback	The callback function to be invoked when a WAV file is no longer being played
[in]	user_data	The user data to be passed to the callback function
[out]	id	The WAV player ID (can be set to `NULL`)

Return values:

WAV_PLAYER_ERROR_NONE	Successful
WAV_PLAYER_ERROR_INVALID_PARAMETER	Invalid parameter
WAV_PLAYER_ERROR_INVALID_OPERATION	Invalid operation
WAV_PLAYER_ERROR_FORMAT_NOT_SUPPORTED	Not supported format
WAV_PLAYER_ERROR_NOT_SUPPORTED_TYPE	Not supported stream type

Postcondition:: It invokes wav_player_playback_completed_cb() when a WAV file is no longer being played.

See also:: wav_player_stop(); wav_player_playback_completed_cb(); sound_manager_create_stream_information(); sound_manager_destroy_stream_information()

int wav_player_stop ( int id )

Stops playing the WAV file.

Parameters:

[in] id The WAV player ID to stop

Return values:

WAV_PLAYER_ERROR_NONE	Successful
WAV_PLAYER_ERROR_INVALID_PARAMETER	Invalid parameter
WAV_PLAYER_ERROR_INVALID_OPERATION	Invalid operation