1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190
|
/* Copyright 2012 The Chromium Authors
* Use of this source code is governed by a BSD-style license that can be
* found in the LICENSE file.
*/
/* From ppb_audio.idl modified Fri Jan 24 16:18:44 2014. */
#ifndef PPAPI_C_PPB_AUDIO_H_
#define PPAPI_C_PPB_AUDIO_H_
#include "ppapi/c/pp_bool.h"
#include "ppapi/c/pp_instance.h"
#include "ppapi/c/pp_macros.h"
#include "ppapi/c/pp_resource.h"
#include "ppapi/c/pp_stdint.h"
#include "ppapi/c/pp_time.h"
#define PPB_AUDIO_INTERFACE_1_0 "PPB_Audio;1.0"
#define PPB_AUDIO_INTERFACE_1_1 "PPB_Audio;1.1"
#define PPB_AUDIO_INTERFACE PPB_AUDIO_INTERFACE_1_1
/**
* @file
* This file defines the <code>PPB_Audio</code> interface, which provides
* realtime stereo audio streaming capabilities.
*/
/**
* @addtogroup Typedefs
* @{
*/
/**
* <code>PPB_Audio_Callback</code> defines the type of an audio callback
* function used to fill the audio buffer with data. Please see the
* Create() function in the <code>PPB_Audio</code> interface for
* more details on this callback.
*
* @param[in] sample_buffer A buffer to fill with audio data.
* @param[in] buffer_size_in_bytes The size of the buffer in bytes.
* @param[in] latency How long before the audio data is to be presented.
* @param[inout] user_data An opaque pointer that was passed into
* <code>PPB_Audio.Create()</code>.
*/
typedef void (*PPB_Audio_Callback)(void* sample_buffer,
uint32_t buffer_size_in_bytes,
PP_TimeDelta latency,
void* user_data);
typedef void (*PPB_Audio_Callback_1_0)(void* sample_buffer,
uint32_t buffer_size_in_bytes,
void* user_data);
/**
* @}
*/
/**
* @addtogroup Interfaces
* @{
*/
/**
* The <code>PPB_Audio</code> interface contains pointers to several functions
* for handling audio resources. Refer to the
* <a href="/native-client/devguide/coding/audio.html">Audio</a>
* chapter in the Developer's Guide for information on using this interface.
* Please see descriptions for each <code>PPB_Audio</code> and
* <code>PPB_AudioConfig</code> function for more details. A C example using
* <code>PPB_Audio</code> and <code>PPB_AudioConfig</code> follows.
*
* <strong>Example: </strong>
*
* @code
* void audio_callback(void* sample_buffer,
* uint32_t buffer_size_in_bytes,
* void* user_data) {
* ... quickly fill in the buffer with samples and return to caller ...
* }
*
* ...Assume the application has cached the audio configuration interface in
* audio_config_interface and the audio interface in
* audio_interface...
*
* uint32_t count = audio_config_interface->RecommendSampleFrameCount(
* PP_AUDIOSAMPLERATE_44100, 4096);
* PP_Resource pp_audio_config = audio_config_interface->CreateStereo16Bit(
* pp_instance, PP_AUDIOSAMPLERATE_44100, count);
* PP_Resource pp_audio = audio_interface->Create(pp_instance, pp_audio_config,
* audio_callback, NULL);
* audio_interface->StartPlayback(pp_audio);
*
* ...audio_callback() will now be periodically invoked on a separate thread...
* @endcode
*/
struct PPB_Audio_1_1 {
/**
* Create() 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 <code>PPB_Audio</code> functions. The
* callback will be called on a different thread than the one which created
* the interface. For performance-critical applications (i.e. 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 <code>AudioConfig</code> documentation.
*
* @param[in] instance A <code>PP_Instance</code> identifying one instance
* of a module.
* @param[in] config A <code>PP_Resource</code> corresponding to an audio
* config resource.
* @param[in] audio_callback A <code>PPB_Audio_Callback</code> callback
* function that the browser calls when it needs more samples to play.
* @param[in] user_data A pointer to user data used in the callback function.
*
* @return A <code>PP_Resource</code> containing the audio resource if
* successful or 0 if the configuration cannot be honored or the callback is
* null.
*/
PP_Resource (*Create)(PP_Instance instance,
PP_Resource config,
PPB_Audio_Callback audio_callback,
void* user_data);
/**
* IsAudio() determines if the provided resource is an audio resource.
*
* @param[in] resource A <code>PP_Resource</code> corresponding to a generic
* resource.
*
* @return A <code>PP_Bool</code> containing containing <code>PP_TRUE</code>
* if the given resource is an Audio resource, otherwise
* <code>PP_FALSE</code>.
*/
PP_Bool (*IsAudio)(PP_Resource resource);
/**
* GetCurrrentConfig() returns an audio config resource for the given audio
* resource.
*
* @param[in] config A <code>PP_Resource</code> corresponding to an audio
* resource.
*
* @return A <code>PP_Resource</code> containing the audio config resource if
* successful.
*/
PP_Resource (*GetCurrentConfig)(PP_Resource audio);
/**
* StartPlayback() starts the playback of the audio resource and begins
* periodically calling the callback.
*
* @param[in] config A <code>PP_Resource</code> corresponding to an audio
* resource.
*
* @return A <code>PP_Bool</code> containing <code>PP_TRUE</code> if
* successful, otherwise <code>PP_FALSE</code>. Also returns
* <code>PP_TRUE</code> (and be a no-op) if called while playback is already
* in progress.
*/
PP_Bool (*StartPlayback)(PP_Resource audio);
/**
* StopPlayback() stops the playback of the audio resource.
*
* @param[in] config A <code>PP_Resource</code> corresponding to an audio
* resource.
*
* @return A <code>PP_Bool</code> containing <code>PP_TRUE</code> if
* successful, otherwise <code>PP_FALSE</code>. Also returns
* <code>PP_TRUE</code> (and is a no-op) if called while playback is already
* stopped. If a callback is in progress, StopPlayback() will block until the
* callback completes.
*/
PP_Bool (*StopPlayback)(PP_Resource audio);
};
typedef struct PPB_Audio_1_1 PPB_Audio;
struct PPB_Audio_1_0 {
PP_Resource (*Create)(PP_Instance instance,
PP_Resource config,
PPB_Audio_Callback_1_0 audio_callback,
void* user_data);
PP_Bool (*IsAudio)(PP_Resource resource);
PP_Resource (*GetCurrentConfig)(PP_Resource audio);
PP_Bool (*StartPlayback)(PP_Resource audio);
PP_Bool (*StopPlayback)(PP_Resource audio);
};
/**
* @}
*/
#endif /* PPAPI_C_PPB_AUDIO_H_ */
|