blob: 8040c04ebeb8b98edb927434c3c5b8969ca0ba19 (
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
|
/*
* Copyright (C) 2016 The Android Open Source Project
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.mozilla.thirdparty.com.google.android.exoplayer2.decoder;
import androidx.annotation.Nullable;
/**
* A media decoder.
*
* @param <I> The type of buffer input to the decoder.
* @param <O> The type of buffer output from the decoder.
* @param <E> The type of exception thrown from the decoder.
*/
public interface Decoder<I, O, E extends Exception> {
/**
* Returns the name of the decoder.
*
* @return The name of the decoder.
*/
String getName();
/**
* Dequeues the next input buffer to be filled and queued to the decoder.
*
* @return The input buffer, which will have been cleared, or null if a buffer isn't available.
* @throws E If a decoder error has occurred.
*/
@Nullable
I dequeueInputBuffer() throws E;
/**
* Queues an input buffer to the decoder.
*
* @param inputBuffer The input buffer.
* @throws E If a decoder error has occurred.
*/
void queueInputBuffer(I inputBuffer) throws E;
/**
* Dequeues the next output buffer from the decoder.
*
* @return The output buffer, or null if an output buffer isn't available.
* @throws E If a decoder error has occurred.
*/
@Nullable
O dequeueOutputBuffer() throws E;
/**
* Flushes the decoder. Ownership of dequeued input buffers is returned to the decoder. The caller
* is still responsible for releasing any dequeued output buffers.
*/
void flush();
/**
* Releases the decoder. Must be called when the decoder is no longer needed.
*/
void release();
}
|
