MediaFormat (dttvlib API)

java.lang.Object
- app.dttv.dttvlib.MediaFormat

```
public final class MediaFormat
extends Object
```
Encapsulates the information describing the format of media data, be it audio or video. The format of the media data is specified as string/value pairs. Keys common to all audio/video formats, all keys not marked optional are mandatory: Video formats have the following keys: Specify both KEY_MAX_WIDTH and KEY_MAX_HEIGHT to enable adaptive playback (seamless resolution change) for a video decoder that supports it The values are used as hints for the codec: they are the maximum expected resolution to prepare for. Depending on codec support, preparing for larger maximum resolution may require more memory even if that resolution is never reached. These fields have no effect for codecs that do not support adaptive playback.

字段概要

字段
限定符和类型	字段和说明
`static String`	`KEY_AAC_PROFILE` A key describing the AAC profile to be used (AAC audio formats only).
`static String`	`KEY_BIT_RATE` A key describing the bitrate in bits/sec.
`static String`	`KEY_CHANNEL_COUNT` A key describing the number of channels in an audio format.
`static String`	`KEY_CHANNEL_MASK` A key describing the channel composition of audio content.
`static String`	`KEY_COLOR_FORMAT` A key describing the color format of the content in a video format.
`static String`	`KEY_DURATION` A key describing the duration (in microseconds) of the content.
`static String`	`KEY_FLAC_COMPRESSION_LEVEL` A key describing the FLAC compression level to be used (FLAC audio format only).
`static String`	`KEY_FRAME_RATE` A key describing the frame rate of a video format in frames/sec.
`static String`	`KEY_HEIGHT` A key describing the height of the content in a video format.
`static String`	`KEY_I_FRAME_INTERVAL` A key describing the frequency of I frames expressed in secs between I frames.
`static String`	`KEY_IS_ADTS` A key mapping to a value of 1 if the content is AAC audio and audio frames are prefixed with an ADTS header.
`static String`	`KEY_IS_AUTOSELECT` A key for boolean AUTOSELECT behavior for the track.
`static String`	`KEY_IS_DEFAULT` A key for boolean DEFAULT behavior for the track.
`static String`	`KEY_IS_FORCED_SUBTITLE` A key for the FORCED field for subtitle tracks.
`static String`	`KEY_LANGUAGE` A key describing the language of the content, using either ISO 639-1 or 639-2/T codes.
`static String`	`KEY_MAX_HEIGHT` A key describing the maximum expected height of the content in a video decoder format, in case there are resolution changes in the video content.
`static String`	`KEY_MAX_INPUT_SIZE` A key describing the maximum size in bytes of a buffer of data described by this MediaFormat.
`static String`	`KEY_MAX_WIDTH` A key describing the maximum expected width of the content in a video decoder format, in case there are resolution changes in the video content.
`static String`	`KEY_MIME` A key describing the mime type of the MediaFormat.
`static String`	`KEY_PATH` A key describing the external subtitle path
`static String`	`KEY_PUSH_BLANK_BUFFERS_ON_STOP` If specified when configuring a video decoder rendering to a surface, causes the decoder to output "blank", i.e. black frames to the surface when stopped to clear out any previously displayed contents.
`static String`	`KEY_REPEAT_PREVIOUS_FRAME_AFTER` Applies only when configuring a video encoder in "surface-input" mode.
`static String`	`KEY_SAMPLE_RATE` A key describing the sample rate of an audio format.
`static String`	`KEY_SLICE_HEIGHT`
`static String`	`KEY_STRIDE`
`static String`	`KEY_TITLE` A key describing the title of the content
`static String`	`KEY_WIDTH` A key describing the width of the content in a video format.

构造器概要

构造器
构造器和说明

MediaFormat()
Creates an empty MediaFormat

构造器
构造器和说明
`MediaFormat()` Creates an empty MediaFormat

方法概要

所有方法静态方法实例方法具体方法
限定符和类型	方法和说明
`boolean`	`containsKey(String name)` Returns true iff a key of the given name exists in the format.
`static MediaFormat`	`createAudioFormat(String mime, int sampleRate, int channelCount)` Creates a minimal audio format.
`static MediaFormat`	`createSubtitleFormat(String title, String language)` Creates a minimal subtitle format.
`static MediaFormat`	`createVideoFormat(String mime, int width, int height)` Creates a minimal video format.
`ByteBuffer`	`getByteBuffer(String name)` Returns the value of a ByteBuffer key.
`float`	`getFloat(String name)` Returns the value of a float key.
`int`	`getInteger(String name)` Returns the value of an integer key.
`int`	`getInteger(String name, int defaultValue)` Returns the value of an integer key, or the default value if the key is missing or is for another type value.
`long`	`getLong(String name)` Returns the value of a long key.
`String`	`getString(String name)` Returns the value of a string key.
`void`	`setByteBuffer(String name, ByteBuffer bytes)` Sets the value of a ByteBuffer key.
`void`	`setFloat(String name, float value)` Sets the value of a float key.
`void`	`setInteger(String name, int value)` Sets the value of an integer key.
`void`	`setLong(String name, long value)` Sets the value of a long key.
`void`	`setString(String name, String value)` Sets the value of a string key.
`String`	`toString()`

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- 字段详细资料
  - KEY_MIME
```
public static final String KEY_MIME
```
    A key describing the mime type of the MediaFormat. The associated value is a string.
    
    另请参阅:
    
    常量字段值
  - KEY_LANGUAGE
```
public static final String KEY_LANGUAGE
```
    A key describing the language of the content, using either ISO 639-1 or 639-2/T codes. The associated value is a string.
    
    另请参阅:
    
    常量字段值
  - KEY_TITLE
```
public static final String KEY_TITLE
```
    A key describing the title of the content
    
    另请参阅:
    
    常量字段值
  - KEY_PATH
```
public static final String KEY_PATH
```
    A key describing the external subtitle path
    
    另请参阅:
    
    常量字段值
  - KEY_SAMPLE_RATE
```
public static final String KEY_SAMPLE_RATE
```
    A key describing the sample rate of an audio format. The associated value is an integer
    
    另请参阅:
    
    常量字段值
  - KEY_CHANNEL_COUNT
```
public static final String KEY_CHANNEL_COUNT
```
    A key describing the number of channels in an audio format. The associated value is an integer
    
    另请参阅:
    
    常量字段值
  - KEY_WIDTH
```
public static final String KEY_WIDTH
```
    A key describing the width of the content in a video format. The associated value is an integer
    
    另请参阅:
    
    常量字段值
  - KEY_HEIGHT
```
public static final String KEY_HEIGHT
```
    A key describing the height of the content in a video format. The associated value is an integer
    
    另请参阅:
    
    常量字段值
  - KEY_MAX_WIDTH
```
public static final String KEY_MAX_WIDTH
```
    A key describing the maximum expected width of the content in a video decoder format, in case there are resolution changes in the video content. The associated value is an integer
    
    另请参阅:
    
    常量字段值
  - KEY_MAX_HEIGHT
```
public static final String KEY_MAX_HEIGHT
```
    A key describing the maximum expected height of the content in a video decoder format, in case there are resolution changes in the video content. The associated value is an integer
    
    另请参阅:
    
    常量字段值
  - KEY_MAX_INPUT_SIZE
```
public static final String KEY_MAX_INPUT_SIZE
```
    A key describing the maximum size in bytes of a buffer of data described by this MediaFormat. The associated value is an integer
    
    另请参阅:
    
    常量字段值
  - KEY_BIT_RATE
```
public static final String KEY_BIT_RATE
```
    A key describing the bitrate in bits/sec. The associated value is an integer
    
    另请参阅:
    
    常量字段值
  - KEY_COLOR_FORMAT
```
public static final String KEY_COLOR_FORMAT
```
    A key describing the color format of the content in a video format. Constants are declared in MediaCodecInfo.CodecCapabilities.
    
    另请参阅:
    
    常量字段值
  - KEY_FRAME_RATE
```
public static final String KEY_FRAME_RATE
```
    A key describing the frame rate of a video format in frames/sec. The associated value is an integer or a float.
    
    另请参阅:
    
    常量字段值
  - KEY_I_FRAME_INTERVAL
```
public static final String KEY_I_FRAME_INTERVAL
```
    A key describing the frequency of I frames expressed in secs between I frames. The associated value is an integer.
    
    另请参阅:
    
    常量字段值
  - KEY_STRIDE
```
public static final String KEY_STRIDE
```
    另请参阅:
    
    常量字段值
  - KEY_SLICE_HEIGHT
```
public static final String KEY_SLICE_HEIGHT
```
    另请参阅:
    
    常量字段值
  - KEY_REPEAT_PREVIOUS_FRAME_AFTER
```
public static final String KEY_REPEAT_PREVIOUS_FRAME_AFTER
```
    Applies only when configuring a video encoder in "surface-input" mode. The associated value is a long and gives the time in microseconds after which the frame previously submitted to the encoder will be repeated (once) if no new frame became available since.
    
    另请参阅:
    
    常量字段值
  - KEY_PUSH_BLANK_BUFFERS_ON_STOP
```
public static final String KEY_PUSH_BLANK_BUFFERS_ON_STOP
```
    If specified when configuring a video decoder rendering to a surface, causes the decoder to output "blank", i.e. black frames to the surface when stopped to clear out any previously displayed contents. The associated value is an integer of value 1.
    
    另请参阅:
    
    常量字段值
  - KEY_DURATION
```
public static final String KEY_DURATION
```
    A key describing the duration (in microseconds) of the content. The associated value is a long.
    
    另请参阅:
    
    常量字段值
  - KEY_IS_ADTS
```
public static final String KEY_IS_ADTS
```
    A key mapping to a value of 1 if the content is AAC audio and audio frames are prefixed with an ADTS header. The associated value is an integer (0 or 1). This key is only supported when _decoding_ content, it cannot be used to configure an encoder to emit ADTS output.
    
    另请参阅:
    
    常量字段值
  - KEY_CHANNEL_MASK
```
public static final String KEY_CHANNEL_MASK
```
    A key describing the channel composition of audio content. This mask is composed of bits drawn from channel mask definitions in AudioFormat. The associated value is an integer.
    
    另请参阅:
    
    常量字段值
  - KEY_AAC_PROFILE
```
public static final String KEY_AAC_PROFILE
```
    A key describing the AAC profile to be used (AAC audio formats only). Constants are declared in MediaCodecInfo.CodecProfileLevel.
    
    另请参阅:
    
    常量字段值
  - KEY_FLAC_COMPRESSION_LEVEL
```
public static final String KEY_FLAC_COMPRESSION_LEVEL
```
    A key describing the FLAC compression level to be used (FLAC audio format only). The associated value is an integer ranging from 0 (fastest, least compression) to 8 (slowest, most compression).
    
    另请参阅:
    
    常量字段值
  - KEY_IS_AUTOSELECT
```
public static final String KEY_IS_AUTOSELECT
```
    A key for boolean AUTOSELECT behavior for the track. Tracks with AUTOSELECT=true are considered when automatically selecting a track without specific user choice, based on the current locale. This is currently only used for subtitle tracks, when the user selected 'Default' for the captioning locale. The associated value is an integer, where non-0 means TRUE. This is an optional field; if not specified, AUTOSELECT defaults to TRUE.
    
    另请参阅:
    
    常量字段值
  - KEY_IS_DEFAULT
```
public static final String KEY_IS_DEFAULT
```
    A key for boolean DEFAULT behavior for the track. The track with DEFAULT=true is selected in the absence of a specific user choice. This is currently only used for subtitle tracks, when the user selected 'Default' for the captioning locale. The associated value is an integer, where non-0 means TRUE. This is an optional field; if not specified, DEFAULT is considered to be FALSE.
    
    另请参阅:
    
    常量字段值
  - KEY_IS_FORCED_SUBTITLE
```
public static final String KEY_IS_FORCED_SUBTITLE
```
    A key for the FORCED field for subtitle tracks. True if it is a forced subtitle track. Forced subtitle tracks are essential for the content and are shown even when the user turns off Captions. They are used for example to translate foreign/alien dialogs or signs. The associated value is an integer, where non-0 means TRUE. This is an optional field; if not specified, FORCED defaults to FALSE.
    
    另请参阅:
    
    常量字段值
- 构造器详细资料
  - MediaFormat
```
public MediaFormat()
```
    Creates an empty MediaFormat
- 方法详细资料
  - containsKey
```
public final boolean containsKey(String name)
```
    Returns true iff a key of the given name exists in the format.
  - getInteger
```
public final int getInteger(String name)
```
    Returns the value of an integer key.
  - getInteger
```
public final int getInteger(String name,
                            int defaultValue)
```
    Returns the value of an integer key, or the default value if the key is missing or is for another type value.
  - getLong
```
public final long getLong(String name)
```
    Returns the value of a long key.
  - getFloat
```
public final float getFloat(String name)
```
    Returns the value of a float key.
  - getString
```
public final String getString(String name)
```
    Returns the value of a string key.
  - getByteBuffer
```
public final ByteBuffer getByteBuffer(String name)
```
    Returns the value of a ByteBuffer key.
  - setInteger
```
public final void setInteger(String name,
                             int value)
```
    Sets the value of an integer key.
  - setLong
```
public final void setLong(String name,
                          long value)
```
    Sets the value of a long key.
  - setFloat
```
public final void setFloat(String name,
                           float value)
```
    Sets the value of a float key.
  - setString
```
public final void setString(String name,
                            String value)
```
    Sets the value of a string key.
  - setByteBuffer
```
public final void setByteBuffer(String name,
                                ByteBuffer bytes)
```
    Sets the value of a ByteBuffer key.
  - createAudioFormat
```
public static final MediaFormat createAudioFormat(String mime,
                                                  int sampleRate,
                                                  int channelCount)
```
    Creates a minimal audio format.
    
    参数:
    
    mime - The mime type of the content.
    
    sampleRate - The sampling rate of the content.
    
    channelCount - The number of audio channels in the content.
  - createSubtitleFormat
```
public static final MediaFormat createSubtitleFormat(String title,
                                                     String language)
```
    Creates a minimal subtitle format.
    
    参数:
    
    title - The content of the Subtitle
    
    language - The language of the content, using either ISO 639-1 or 639-2/T codes. Specify null or "und" if language information is only included in the content. (This will also work if there are multiple language tracks in the content.)
  - createVideoFormat
```
public static final MediaFormat createVideoFormat(String mime,
                                                  int width,
                                                  int height)
```
    Creates a minimal video format.
    
    参数:
    
    mime - The mime type of the content.
    
    width - The width of the content (in pixels)
    
    height - The height of the content (in pixels)
  - toString
```
public String toString()
```
    覆盖:
    
    toString 在类中 Object

类 MediaFormat

字段概要

构造器概要

方法概要

从类继承的方法 java.lang.Object

字段详细资料

KEY_MIME

KEY_LANGUAGE

KEY_TITLE

KEY_PATH

KEY_SAMPLE_RATE

KEY_CHANNEL_COUNT

KEY_WIDTH

KEY_HEIGHT

KEY_MAX_WIDTH

KEY_MAX_HEIGHT

KEY_MAX_INPUT_SIZE

KEY_BIT_RATE

KEY_COLOR_FORMAT

KEY_FRAME_RATE

KEY_I_FRAME_INTERVAL

KEY_STRIDE

KEY_SLICE_HEIGHT

KEY_REPEAT_PREVIOUS_FRAME_AFTER

KEY_PUSH_BLANK_BUFFERS_ON_STOP

KEY_DURATION

KEY_IS_ADTS

KEY_CHANNEL_MASK

KEY_AAC_PROFILE

KEY_FLAC_COMPRESSION_LEVEL

KEY_IS_AUTOSELECT

KEY_IS_DEFAULT

KEY_IS_FORCED_SUBTITLE

构造器详细资料

MediaFormat

方法详细资料

containsKey

getInteger

getInteger

getLong

getFloat

getString

getByteBuffer

setInteger

setLong

setFloat

setString

setByteBuffer

createAudioFormat

createSubtitleFormat

createVideoFormat

toString