public class

AudioCodec

extends Object
java.lang.Object
   ↳ android.net.rtp.AudioCodec

Class Overview

This class defines a collection of audio codecs to be used with AudioStreams. Their parameters are designed to be exchanged using Session Description Protocol (SDP). Most of the values listed here can be found in RFC 3551, while others are described in separated standards.

Few simple configurations are defined as public static instances for the convenience of direct uses. More complicated ones could be obtained using getCodec(int, String, String). For example, one can use the following snippet to create a mode-1-only AMR codec.

 AudioCodec codec = AudioCodec.getCodec(100, "AMR/8000", "mode-set=1");
 

See Also

Summary

Fields
public static final AudioCodec AMR Adaptive Multi-Rate narrowband audio codec, also known as AMR or AMR-NB.
public static final AudioCodec GSM GSM Full-Rate audio codec, also known as GSM-FR, GSM 06.10, GSM, or simply FR.
public static final AudioCodec GSM_EFR GSM Enhanced Full-Rate audio codec, also known as GSM-EFR, GSM 06.60, or simply EFR.
public static final AudioCodec PCMA G.711 a-law audio codec.
public static final AudioCodec PCMU G.711 u-law audio codec.
public final String fmtp The format parameters to be used in the corresponding SDP attribute.
public final String rtpmap The encoding parameters to be used in the corresponding SDP attribute.
public final int type The RTP payload type of the encoding.
Public Methods
static AudioCodec getCodec(int type, String rtpmap, String fmtp)
Creates an AudioCodec according to the given configuration.
static AudioCodec[] getCodecs()
Returns system supported audio codecs.
[Expand]
Inherited Methods
From class java.lang.Object

Fields

public static final AudioCodec AMR

Since: API Level 12

Adaptive Multi-Rate narrowband audio codec, also known as AMR or AMR-NB. Currently CRC, robust sorting, and interleaving are not supported. See more details about these features in RFC 4867.

public static final AudioCodec GSM

Since: API Level 12

GSM Full-Rate audio codec, also known as GSM-FR, GSM 06.10, GSM, or simply FR.

public static final AudioCodec GSM_EFR

Since: API Level 12

GSM Enhanced Full-Rate audio codec, also known as GSM-EFR, GSM 06.60, or simply EFR.

public static final AudioCodec PCMA

Since: API Level 12

G.711 a-law audio codec.

public static final AudioCodec PCMU

Since: API Level 12

G.711 u-law audio codec.

public final String fmtp

Since: API Level 12

The format parameters to be used in the corresponding SDP attribute.

public final String rtpmap

Since: API Level 12

The encoding parameters to be used in the corresponding SDP attribute.

public final int type

Since: API Level 12

The RTP payload type of the encoding.

Public Methods

public static AudioCodec getCodec (int type, String rtpmap, String fmtp)

Since: API Level 12

Creates an AudioCodec according to the given configuration.

Parameters
type The payload type of the encoding defined in RTP/AVP.
rtpmap The encoding parameters specified in the corresponding SDP attribute, or null if it is not available.
fmtp The format parameters specified in the corresponding SDP attribute, or null if it is not available.
Returns
  • The configured AudioCodec or null if it is not supported.

public static AudioCodec[] getCodecs ()

Since: API Level 12

Returns system supported audio codecs.