blob: ed9e0983c11d35840da9b0df2134f4d056d1a7a0 (
plain)
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
|
/* Copyright (c) 2011 The Chromium Authors. All rights reserved.
* Use of this source code is governed by a BSD-style license that can be
* found in the LICENSE file.
*/
/* From dev/ppb_audio_input_dev.idl modified Mon Nov 14 17:58:16 2011. */
#ifndef PPAPI_C_DEV_PPB_AUDIO_INPUT_DEV_H_
#define PPAPI_C_DEV_PPB_AUDIO_INPUT_DEV_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"
#define PPB_AUDIO_INPUT_DEV_INTERFACE_0_1 "PPB_AudioInput(Dev);0.1"
#define PPB_AUDIO_INPUT_DEV_INTERFACE PPB_AUDIO_INPUT_DEV_INTERFACE_0_1
/**
* @file
* This file defines the <code>PPB_AudioInput_Dev</code> interface, which
* provides realtime audio input capture.
*/
/**
* @addtogroup Typedefs
* @{
*/
/**
* <code>PPB_AudioInput_Callback</code> defines the type of an audio callback
* function used to provide the audio buffer with data. This callback will be
* called on a separate thread to the creation thread.
*/
typedef void (*PPB_AudioInput_Callback)(void* sample_buffer,
uint32_t buffer_size_in_bytes,
void* user_data);
/**
* @}
*/
/**
* @addtogroup Interfaces
* @{
*/
/**
* The <code>PPB_AudioInput_Dev</code> interface contains pointers to several
* functions for handling audio input resources.
*/
struct PPB_AudioInput_Dev {
/**
* Create is a pointer to a function that creates an audio input resource.
* No sound will be captured until StartCapture() is called.
*/
PP_Resource (*Create)(PP_Instance instance,
PP_Resource config,
PPB_AudioInput_Callback audio_input_callback,
void* user_data);
/**
* IsAudioInput is a pointer to a function that determines if the given
* resource is an audio input resource.
*
* @param[in] resource A PP_Resource containing a resource.
*
* @return A PP_BOOL containing containing PP_TRUE if the given resource is
* an audio input resource, otherwise PP_FALSE.
*/
PP_Bool (*IsAudioInput)(PP_Resource audio_input);
/**
* 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_input);
/**
* StartCapture() starts the capture of the audio input resource and begins
* periodically calling the callback.
*
* @param[in] config A <code>PP_Resource</code> corresponding to an audio
* input 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 callback is already
* in progress.
*/
PP_Bool (*StartCapture)(PP_Resource audio_input);
/**
* StopCapture is a pointer to a function that stops the capture of
* the audio input resource.
*
* @param[in] config A PP_Resource containing the audio input resource.
*
* @return A PP_BOOL containing PP_TRUE if successful, otherwise PP_FALSE.
* Also returns PP_TRUE (and is a no-op) if called while capture is already
* stopped. If a buffer is being captured, StopCapture will block until the
* call completes.
*/
PP_Bool (*StopCapture)(PP_Resource audio_input);
};
/**
* @}
*/
#endif /* PPAPI_C_DEV_PPB_AUDIO_INPUT_DEV_H_ */
|
