RendererCapabilities (library-core API)

All Known Implementing Classes:

BaseRenderer, CameraMotionRenderer, MediaCodecAudioRenderer, MediaCodecRenderer, MediaCodecVideoRenderer, MetadataRenderer, NoSampleRenderer, SimpleDecoderAudioRenderer, TextRenderer
```
public interface RendererCapabilities
```
Defines the capabilities of a Renderer.

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`ADAPTIVE_NOT_SEAMLESS` The `Renderer` can adapt between formats, but may suffer a brief discontinuity (~50-100ms) when adaptation occurs.
`static int`	`ADAPTIVE_NOT_SUPPORTED` The `Renderer` does not support adaptation between formats.
`static int`	`ADAPTIVE_SEAMLESS` The `Renderer` can seamlessly adapt between formats.
`static int`	`ADAPTIVE_SUPPORT_MASK` A mask to apply to the result of `supportsFormat(Format)` to obtain one of `ADAPTIVE_SEAMLESS`, `ADAPTIVE_NOT_SEAMLESS` and `ADAPTIVE_NOT_SUPPORTED`.
`static int`	`FORMAT_EXCEEDS_CAPABILITIES` The `Renderer` is capable of rendering formats with the same mime type, but the properties of the format exceed the renderer's capabilities.
`static int`	`FORMAT_HANDLED` The `Renderer` is capable of rendering the format.
`static int`	`FORMAT_SUPPORT_MASK` A mask to apply to the result of `supportsFormat(Format)` to obtain one of `FORMAT_HANDLED`, `FORMAT_EXCEEDS_CAPABILITIES`, `FORMAT_UNSUPPORTED_DRM`, `FORMAT_UNSUPPORTED_SUBTYPE` and `FORMAT_UNSUPPORTED_TYPE`.
`static int`	`FORMAT_UNSUPPORTED_DRM` The `Renderer` is capable of rendering formats with the same mime type, but is not capable of rendering the format because the format's drm protection is not supported.
`static int`	`FORMAT_UNSUPPORTED_SUBTYPE` The `Renderer` is a general purpose renderer for formats of the same top-level type, but is not capable of rendering the format or any other format with the same mime type because the sub-type is not supported.
`static int`	`FORMAT_UNSUPPORTED_TYPE` The `Renderer` is not capable of rendering the format, either because it does not support the format's top-level type, or because it's a specialized renderer for a different mime type.
`static int`	`TUNNELING_NOT_SUPPORTED` The `Renderer` does not support tunneled output.
`static int`	`TUNNELING_SUPPORT_MASK` A mask to apply to the result of `supportsFormat(Format)` to obtain one of `TUNNELING_SUPPORTED` and `TUNNELING_NOT_SUPPORTED`.
`static int`	`TUNNELING_SUPPORTED` The `Renderer` supports tunneled output.

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method and Description
`int`	`getTrackType()` Returns the track type that the `Renderer` handles.
`int`	`supportsFormat(Format format)` Returns the extent to which the `Renderer` supports a given format.
`int`	`supportsMixedMimeTypeAdaptation()` Returns the extent to which the `Renderer` supports adapting between supported formats that have different mime types.

- Field Detail
  - FORMAT_SUPPORT_MASK
```
static final int FORMAT_SUPPORT_MASK
```
    A mask to apply to the result of supportsFormat(Format) to obtain one of FORMAT_HANDLED, FORMAT_EXCEEDS_CAPABILITIES, FORMAT_UNSUPPORTED_DRM, FORMAT_UNSUPPORTED_SUBTYPE and FORMAT_UNSUPPORTED_TYPE.
    
    See Also:
    
    Constant Field Values
  - FORMAT_HANDLED
```
static final int FORMAT_HANDLED
```
    The Renderer is capable of rendering the format.
    
    See Also:
    
    Constant Field Values
  - FORMAT_EXCEEDS_CAPABILITIES
```
static final int FORMAT_EXCEEDS_CAPABILITIES
```
    The Renderer is capable of rendering formats with the same mime type, but the properties of the format exceed the renderer's capabilities. There is a chance the renderer will be able to play the format in practice because some renderers report their capabilities conservatively, but the expected outcome is that playback will fail.
    Example: The Renderer is capable of rendering H264 and the format's mime type is MimeTypes.VIDEO_H264, but the format's resolution exceeds the maximum limit supported by the underlying H264 decoder.
    
    See Also:
    
    Constant Field Values
  - FORMAT_UNSUPPORTED_DRM
```
static final int FORMAT_UNSUPPORTED_DRM
```
    The Renderer is capable of rendering formats with the same mime type, but is not capable of rendering the format because the format's drm protection is not supported.
    Example: The Renderer is capable of rendering H264 and the format's mime type is MimeTypes.VIDEO_H264, but the format indicates PlayReady drm protection where-as the renderer only supports Widevine.
    
    See Also:
    
    Constant Field Values
  - FORMAT_UNSUPPORTED_SUBTYPE
```
static final int FORMAT_UNSUPPORTED_SUBTYPE
```
    The Renderer is a general purpose renderer for formats of the same top-level type, but is not capable of rendering the format or any other format with the same mime type because the sub-type is not supported.
    Example: The Renderer is a general purpose audio renderer and the format's mime type matches audio/[subtype], but there does not exist a suitable decoder for [subtype].
    
    See Also:
    
    Constant Field Values
  - FORMAT_UNSUPPORTED_TYPE
```
static final int FORMAT_UNSUPPORTED_TYPE
```
    The Renderer is not capable of rendering the format, either because it does not support the format's top-level type, or because it's a specialized renderer for a different mime type.
    Example: The Renderer is a general purpose video renderer, but the format has an audio mime type.
    
    See Also:
    
    Constant Field Values
  - ADAPTIVE_SUPPORT_MASK
```
static final int ADAPTIVE_SUPPORT_MASK
```
    A mask to apply to the result of supportsFormat(Format) to obtain one of ADAPTIVE_SEAMLESS, ADAPTIVE_NOT_SEAMLESS and ADAPTIVE_NOT_SUPPORTED.
    
    See Also:
    
    Constant Field Values
  - ADAPTIVE_SEAMLESS
```
static final int ADAPTIVE_SEAMLESS
```
    The Renderer can seamlessly adapt between formats.
    
    See Also:
    
    Constant Field Values
  - ADAPTIVE_NOT_SEAMLESS
```
static final int ADAPTIVE_NOT_SEAMLESS
```
    The Renderer can adapt between formats, but may suffer a brief discontinuity (~50-100ms) when adaptation occurs.
    
    See Also:
    
    Constant Field Values
  - ADAPTIVE_NOT_SUPPORTED
```
static final int ADAPTIVE_NOT_SUPPORTED
```
    The Renderer does not support adaptation between formats.
    
    See Also:
    
    Constant Field Values
  - TUNNELING_SUPPORT_MASK
```
static final int TUNNELING_SUPPORT_MASK
```
    A mask to apply to the result of supportsFormat(Format) to obtain one of TUNNELING_SUPPORTED and TUNNELING_NOT_SUPPORTED.
    
    See Also:
    
    Constant Field Values
  - TUNNELING_SUPPORTED
```
static final int TUNNELING_SUPPORTED
```
    The Renderer supports tunneled output.
    
    See Also:
    
    Constant Field Values
  - TUNNELING_NOT_SUPPORTED
```
static final int TUNNELING_NOT_SUPPORTED
```
    The Renderer does not support tunneled output.
    
    See Also:
    
    Constant Field Values
- Method Detail
  - getTrackType
```
int getTrackType()
```
    Returns the track type that the Renderer handles. For example, a video renderer will return C.TRACK_TYPE_VIDEO, an audio renderer will return C.TRACK_TYPE_AUDIO, a text renderer will return C.TRACK_TYPE_TEXT, and so on.
    
    Returns:
    
    One of the TRACK_TYPE_* constants defined in C.
    
    See Also:
    
    Renderer.getTrackType()
  - supportsFormat
```
int supportsFormat(Format format)
            throws ExoPlaybackException
```
    Returns the extent to which the Renderer supports a given format. The returned value is the bitwise OR of three properties:
    - The level of support for the format itself. One of FORMAT_HANDLED, FORMAT_EXCEEDS_CAPABILITIES, FORMAT_UNSUPPORTED_DRM, FORMAT_UNSUPPORTED_SUBTYPE and FORMAT_UNSUPPORTED_TYPE.
    - The level of support for adapting from the format to another format of the same mime type. One of ADAPTIVE_SEAMLESS, ADAPTIVE_NOT_SEAMLESS and ADAPTIVE_NOT_SUPPORTED. Only set if the level of support for the format itself is FORMAT_HANDLED or FORMAT_EXCEEDS_CAPABILITIES.
    - The level of support for tunneling. One of TUNNELING_SUPPORTED and TUNNELING_NOT_SUPPORTED. Only set if the level of support for the format itself is FORMAT_HANDLED or FORMAT_EXCEEDS_CAPABILITIES.
    The individual properties can be retrieved by performing a bitwise AND with FORMAT_SUPPORT_MASK, ADAPTIVE_SUPPORT_MASK and TUNNELING_SUPPORT_MASK respectively.
    Parameters:
    
    format - The format.
    
    Returns:
    
    The extent to which the renderer is capable of supporting the given format.
    
    Throws:
    
    ExoPlaybackException - If an error occurs.
  - supportsMixedMimeTypeAdaptation
```
int supportsMixedMimeTypeAdaptation()
                             throws ExoPlaybackException
```
    Returns the extent to which the Renderer supports adapting between supported formats that have different mime types.
    
    Returns:
    
    The extent to which the renderer supports adapting between supported formats that have different mime types. One of ADAPTIVE_SEAMLESS, ADAPTIVE_NOT_SEAMLESS and ADAPTIVE_NOT_SUPPORTED.
    
    Throws:
    
    ExoPlaybackException - If an error occurs.

Interface RendererCapabilities

Field Summary

Method Summary

Field Detail

FORMAT_SUPPORT_MASK

FORMAT_HANDLED

FORMAT_EXCEEDS_CAPABILITIES

FORMAT_UNSUPPORTED_DRM

FORMAT_UNSUPPORTED_SUBTYPE

FORMAT_UNSUPPORTED_TYPE

ADAPTIVE_SUPPORT_MASK

ADAPTIVE_SEAMLESS

ADAPTIVE_NOT_SEAMLESS

ADAPTIVE_NOT_SUPPORTED

TUNNELING_SUPPORT_MASK

TUNNELING_SUPPORTED

TUNNELING_NOT_SUPPORTED

Method Detail

getTrackType

supportsFormat

supportsMixedMimeTypeAdaptation