Tizen Native API
Functions | Typedefs
WAV Player
Multimedia

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 wave_player_start() 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 (const char *path, sound_type_e type, wav_player_playback_completed_cb callback, void *user_data, int *id)
 Plays a WAV file.
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 is no longer being played.

Typedef Documentation

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

Called when a WAV file is no longer being played.

This callback is not invoked by calling wav_player_stop().

Since :
2.3.1
Parameters:
[in]idThe completed wav player ID
[in]user_dataThe user data passed from the callback registration function
See also:
wav_player_start()

Enumeration Type Documentation

enum wav_player_error_e

Enumeration of error codes for WAV player.

Since :
2.3.1
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

Function Documentation

int wav_player_start ( const char *  path,
sound_type_e  type,
wav_player_playback_completed_cb  callback,
void *  user_data,
int *  id 
)

Plays a WAV file.

Since :
2.3.1
Parameters:
[in]pathThe WAV file path to the file to be played
[in]typeThe sound type
[in]callbackThe callback function to be invoked when a WAV file is no longer being played
[in]user_dataThe user data to be passed to the callback function
[out]idThe WAV player ID (can be set to NULL)
Returns:
0 on success, otherwise a negative error value
Return values:
WAV_PLAYER_ERROR_NONESuccessful
WAV_PLAYER_ERROR_INVALID_PARAMETERInvalid parameter
WAV_PLAYER_ERROR_INVALID_OPERATIONInvalid operation
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()
int wav_player_stop ( int  id)

Stops playing the WAV file.

Since :
2.3.1
Parameters:
[in]idThe WAV player ID to stop
Returns:
0 on success, otherwise a negative error value
Return values:
WAV_PLAYER_ERROR_NONESuccessful
WAV_PLAYER_ERROR_INVALID_PARAMETERInvalid parameter
WAV_PLAYER_ERROR_INVALID_OPERATIONInvalid operation
See also:
wav_player_start()