| OLD | NEW |
| (Empty) |
| 1 /* Copyright 2014 The Chromium Authors. All rights reserved. | |
| 2 * Use of this source code is governed by a BSD-style license that can be | |
| 3 * found in the LICENSE file. | |
| 4 */ | |
| 5 | |
| 6 /** | |
| 7 * Defines the <code>PPB_AudioFrame</code> interface. | |
| 8 */ | |
| 9 | |
| 10 [generate_thunk] | |
| 11 | |
| 12 label Chrome { | |
| 13 [channel=dev] M34 = 0.1 | |
| 14 }; | |
| 15 | |
| 16 /** | |
| 17 * PP_AudioFrame_SampleRate is an enumeration of the different audio sample | |
| 18 * rates. | |
| 19 */ | |
| 20 enum PP_AudioFrame_SampleRate { | |
| 21 PP_AUDIOFRAME_SAMPLERATE_UNKNOWN = 0, | |
| 22 PP_AUDIOFRAME_SAMPLERATE_8000 = 8000, | |
| 23 PP_AUDIOFRAME_SAMPLERATE_44100 = 44100 | |
| 24 }; | |
| 25 | |
| 26 /** | |
| 27 * PP_AudioFrame_SampleSize is an enumeration of the different audio sample | |
| 28 * sizes. | |
| 29 */ | |
| 30 enum PP_AudioFrame_SampleSize { | |
| 31 PP_AUDIOFRAME_SAMPLESIZE_UNKNOWN = 0, | |
| 32 PP_AUDIOFRAME_SAMPLESIZE_16_BITS = 2 | |
| 33 }; | |
| 34 | |
| 35 interface PPB_AudioFrame { | |
| 36 /** | |
| 37 * Determines if a resource is an AudioFrame resource. | |
| 38 * | |
| 39 * @param[in] resource The <code>PP_Resource</code> to test. | |
| 40 * | |
| 41 * @return A <code>PP_Bool</code> with <code>PP_TRUE</code> if the given | |
| 42 * resource is an AudioFrame resource or <code>PP_FALSE</code> otherwise. | |
| 43 */ | |
| 44 PP_Bool IsAudioFrame([in] PP_Resource resource); | |
| 45 | |
| 46 /** | |
| 47 * Gets the timestamp of the audio frame. | |
| 48 * | |
| 49 * @param[in] frame A <code>PP_Resource</code> corresponding to an audio frame | |
| 50 * resource. | |
| 51 * | |
| 52 * @return A <code>PP_TimeDelta</code> containing the timestamp of the audio | |
| 53 * frame. Given in seconds since the start of the containing audio stream. | |
| 54 */ | |
| 55 [on_failure=0.0] | |
| 56 PP_TimeDelta GetTimestamp([in] PP_Resource frame); | |
| 57 | |
| 58 /** | |
| 59 * Sets the timestamp of the audio frame. | |
| 60 * | |
| 61 * @param[in] frame A <code>PP_Resource</code> corresponding to an audio frame | |
| 62 * resource. | |
| 63 * @param[in] timestamp A <code>PP_TimeDelta</code> containing the timestamp | |
| 64 * of the audio frame. Given in seconds since the start of the containing | |
| 65 * audio stream. | |
| 66 */ | |
| 67 void SetTimestamp([in] PP_Resource frame, [in] PP_TimeDelta timestamp); | |
| 68 | |
| 69 /** | |
| 70 * Gets the sample rate of the audio frame. | |
| 71 * | |
| 72 * @param[in] frame A <code>PP_Resource</code> corresponding to an audio frame | |
| 73 * resource. | |
| 74 * | |
| 75 * @return The sample rate of the audio frame. | |
| 76 */ | |
| 77 [on_failure=PP_AUDIOFRAME_SAMPLERATE_UNKNOWN] | |
| 78 PP_AudioFrame_SampleRate GetSampleRate([in] PP_Resource frame); | |
| 79 | |
| 80 /** | |
| 81 * Gets the sample size of the audio frame. | |
| 82 * | |
| 83 * @param[in] frame A <code>PP_Resource</code> corresponding to an audio frame | |
| 84 * resource. | |
| 85 * | |
| 86 * @return The sample size of the audio frame. | |
| 87 */ | |
| 88 [on_failure=PP_AUDIOFRAME_SAMPLESIZE_UNKNOWN] | |
| 89 PP_AudioFrame_SampleSize GetSampleSize([in] PP_Resource frame); | |
| 90 | |
| 91 /** | |
| 92 * Gets the number of channels in the audio frame. | |
| 93 * | |
| 94 * @param[in] frame A <code>PP_Resource</code> corresponding to an audio frame | |
| 95 * resource. | |
| 96 * | |
| 97 * @return The number of channels in the audio frame. | |
| 98 */ | |
| 99 uint32_t GetNumberOfChannels([in] PP_Resource frame); | |
| 100 | |
| 101 /** | |
| 102 * Gets the number of samples in the audio frame. | |
| 103 * | |
| 104 * @param[in] frame A <code>PP_Resource</code> corresponding to an audio frame | |
| 105 * resource. | |
| 106 * | |
| 107 * @return The number of samples in the audio frame. | |
| 108 * For example, at a sampling rate of 44,100 Hz in stereo audio, a frame | |
| 109 * containing 4410 * 2 samples would have a duration of 100 milliseconds. | |
| 110 */ | |
| 111 uint32_t GetNumberOfSamples([in] PP_Resource frame); | |
| 112 | |
| 113 /** | |
| 114 * Gets the data buffer containing the audio frame samples. | |
| 115 * | |
| 116 * @param[in] frame A <code>PP_Resource</code> corresponding to an audio frame | |
| 117 * resource. | |
| 118 * | |
| 119 * @return A pointer to the beginning of the data buffer. | |
| 120 */ | |
| 121 mem_t GetDataBuffer([in] PP_Resource frame); | |
| 122 | |
| 123 /** | |
| 124 * Gets the size of the data buffer in bytes. | |
| 125 * | |
| 126 * @param[in] frame A <code>PP_Resource</code> corresponding to an audio frame | |
| 127 * resource. | |
| 128 * | |
| 129 * @return The size of the data buffer in bytes. | |
| 130 */ | |
| 131 uint32_t GetDataBufferSize([in] PP_Resource frame); | |
| 132 }; | |
| OLD | NEW |