OLD | NEW |
1 // Copyright 2016 The Chromium Authors. All rights reserved. | 1 // Copyright 2016 The Chromium Authors. All rights reserved. |
2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
4 | 4 |
5 module media.interfaces; | 5 module media.interfaces; |
6 | 6 |
7 import "media/mojo/interfaces/media_types.mojom"; | 7 import "media/mojo/interfaces/media_types.mojom"; |
8 | 8 |
9 interface AudioDecoder { | 9 interface AudioDecoder { |
10 // Status of a decode operation. See media::AudioDecoder for description. | 10 // Status of a decode operation. See media::AudioDecoder for description. |
11 enum DecodeStatus { | 11 enum DecodeStatus { |
12 OK, // We're all good. | 12 OK, // We're all good. |
13 ABORTED, // We aborted as a result of Reset() or destruction. | 13 ABORTED, // We aborted as a result of Reset() or destruction. |
14 ERROR, // A decoding error occurred. | 14 ERROR, // A decoding error occurred. |
15 }; | 15 }; |
16 | 16 |
17 // Initializes the AudioDecoder with the audio codec configuration and CDM id. | 17 // Initializes the AudioDecoder with the audio codec configuration and CDM id. |
18 // For the unencrypted streams the |cdm_id| is ignored. Executed the callback | 18 // For the unencrypted streams the |cdm_id| is ignored. Executed the callback |
19 // with whether the initialization succeeded, and whether the pipeline needs | 19 // with whether the initialization succeeded, and whether the pipeline needs |
20 // bitstream conversion. | 20 // bitstream conversion. |
21 Initialize(AudioDecoderConfig config, int32 cdm_id) | 21 Initialize(AudioDecoderClient client, AudioDecoderConfig config, int32 cdm_id) |
22 => (bool success, bool needs_bitstream_conversion); | 22 => (bool success, bool needs_bitstream_conversion); |
23 | 23 |
24 // Sends the |buffer| to the underlying codec. Should be called only after | 24 // Sends the |buffer| to the underlying codec. Should be called only after |
25 // Initialize() succeeds. The callback with the status is called after the | 25 // Initialize() succeeds. The callback with the status is called after the |
26 // decoder has accepted corresponding DecoderBuffer, indicating that the | 26 // decoder has accepted corresponding DecoderBuffer, indicating that the |
27 // pipeline can send next buffer to decode. | 27 // pipeline can send next buffer to decode. |
28 // If |buffer| is an EOS buffer then the decoder must be flushed, i.e. all | 28 // If |buffer| is an EOS buffer then the decoder must be flushed, i.e. all |
29 // pending buffers should be processed, the corresponding decoded buffers | 29 // pending buffers should be processed, the corresponding decoded buffers |
30 // should be returned to the proxy, and only then the service should return | 30 // should be returned to the proxy, and only then the service should return |
31 // DecoderStatus. | 31 // DecoderStatus. |
32 Decode(DecoderBuffer buffer) => (DecodeStatus status); | 32 Decode(DecoderBuffer buffer) => (DecodeStatus status); |
33 | 33 |
34 // Resets decoder state. Should be called only if Initialize() succeeds. | 34 // Resets decoder state. Should be called only if Initialize() succeeds. |
35 // All pending Decode() requests will be finished or aborted, then the method | 35 // All pending Decode() requests will be finished or aborted, then the method |
36 // executes the callback. | 36 // executes the callback. |
37 Reset() => (); | 37 Reset() => (); |
38 }; | 38 }; |
39 | 39 |
40 interface AudioDecoderClient { | 40 interface AudioDecoderClient { |
41 // Sends the decoded audio buffer back to the proxy. | 41 // Sends the decoded audio buffer back to the proxy. |
42 OnBufferDecoded(AudioBuffer buffer); | 42 OnBufferDecoded(AudioBuffer buffer); |
43 }; | 43 }; |
OLD | NEW |