Pepper_47_C++_interfaces
Public Member Functions | List of all members
pp::Audio Class Reference

#include <audio.h>

Inheritance diagram for pp::Audio:
Inheritance graph
Collaboration diagram for pp::Audio:
Collaboration graph

Public Member Functions

 Audio ()
 An empty constructor for an Audio resource. More...
 
 Audio (const InstanceHandle &instance, const AudioConfig &config, PPB_Audio_Callback callback, void *user_data)
 
 Audio (const InstanceHandle &instance, const AudioConfig &config, PPB_Audio_Callback_1_0 callback, void *user_data)
 
AudioConfigconfig ()
 
const AudioConfigconfig () const
 
bool StartPlayback ()
 
bool StopPlayback ()
 
- Public Member Functions inherited from pp::Resource
 Resource ()
 The default constructor. More...
 
 Resource (const Resource &other)
 
virtual ~Resource ()
 Destructor. More...
 
Resourceoperator= (const Resource &other)
 
bool is_null () const
 
PP_Resource pp_resource () const
 
PP_Resource detach ()
 

Additional Inherited Members

- Protected Member Functions inherited from pp::Resource
 Resource (PP_Resource resource)
 
 Resource (PassRef, PP_Resource resource)
 
void PassRefFromConstructor (PP_Resource resource)
 
void Clear ()
 Sets this resource to null. This releases ownership of the resource. More...
 

Detailed Description

An audio resource. Refer to the Audio chapter in the Developer's Guide for information on using this interface.

Definition at line 24 of file audio.h.

Constructor & Destructor Documentation

pp::Audio::Audio ( )
inline

An empty constructor for an Audio resource.

Definition at line 28 of file audio.h.

pp::Audio::Audio ( const InstanceHandle instance,
const AudioConfig config,
PPB_Audio_Callback  callback,
void *  user_data 
)

A constructor that creates an Audio resource. No sound will be heard until StartPlayback() is called. The callback is called with the buffer address and given user data whenever the buffer needs to be filled. From within the callback, you should not call PPB_Audio functions. The callback will be called on a different thread than the one which created the interface. For performance-critical applications (such as low-latency audio), the callback should avoid blocking or calling functions that can obtain locks, such as malloc. The layout and the size of the buffer passed to the audio callback will be determined by the device configuration and is specified in the AudioConfig documentation.

Parameters
[in]instanceThe instance with which this resource will be associated.
[in]configAn AudioConfig containing the audio config resource.
[in]callbackA PPB_Audio_Callback callback function that the browser calls when it needs more samples to play.
[in]user_dataA pointer to user data used in the callback function.

Definition at line 24 of file audio.cc.

References pp::Resource::PassRefFromConstructor(), pp::InstanceHandle::pp_instance(), and pp::Resource::pp_resource().

pp::Audio::Audio ( const InstanceHandle instance,
const AudioConfig config,
PPB_Audio_Callback_1_0  callback,
void *  user_data 
)

A constructor that creates an Audio resource.

Parameters
[in]instanceThe instance with which this resource will be associated.
[in]configAn AudioConfig containing the audio config resource.
[in]callbackA PPB_Audio_Callback_1_0 callback function that the browser calls when it needs more samples to play.
[in]user_dataA pointer to user data used in the callback function.

Definition at line 36 of file audio.cc.

References pp::Resource::PassRefFromConstructor(), pp::InstanceHandle::pp_instance(), and pp::Resource::pp_resource().

Member Function Documentation

AudioConfig& pp::Audio::config ( )
inline

Getter function for returning the internal PPB_AudioConfig struct.

Returns
A mutable reference to the PPB_AudioConfig struct.

Definition at line 72 of file audio.h.

const AudioConfig& pp::Audio::config ( ) const
inline

Getter function for returning the internal PPB_AudioConfig struct.

Returns
A const reference to the internal PPB_AudioConfig struct.

Definition at line 79 of file audio.h.

bool pp::Audio::StartPlayback ( )

StartPlayback() starts playback of audio.

Returns
true if successful, otherwise false.

Definition at line 48 of file audio.cc.

References pp::Resource::pp_resource().

bool pp::Audio::StopPlayback ( )

StopPlayback stops playback of audio.

Returns
true if successful, otherwise false.

Definition at line 60 of file audio.cc.

References pp::Resource::pp_resource().


The documentation for this class was generated from the following files: