Member Function Documentation

QStringList QAndroidMediaFormat::formatKeys() const

Returns a list of all generic format key names that have been set.

The returned list contains only the keys that were set using setKeyValue(), not the standard property names.

See also setKeyValue(), hasFormatKey(), and removeFormatKey().

bool QAndroidMediaFormat::hasFormatKey(const QString &key) const

Returns true if a generic format key key exists, false otherwise.

This method can be used to check whether a key has been set before attempting to retrieve its value.

See also setKeyValue(), removeFormatKey(), and formatKeys().

QVariant QAndroidMediaFormat::keyValue(const QString &key, const QVariant &defaultValue = {}) const

Returns the value for generic format key key, or defaultValue if the key does not exist.

The returned QVariant contains the value with its original type as it was set using setKeyValue().

Example:

format.setKeyValue("priority", 1);
format.setKeyValue("max-input-size", qint64(1024000));

qint32 priority = format.keyValue("priority").toInt();                // qint32
qint64 maxSize = format.keyValue("max-input-size").toLongLong();      // qint64

See also setKeyValue() and hasFormatKey().

void QAndroidMediaFormat::removeFormatKey(const QString &key)

Removes the generic format key key if it exists.

If the key does not exist, this function does nothing.

See also setKeyValue(), hasFormatKey(), and formatKeys().

void QAndroidMediaFormat::setAvcLevel(int avcLevel)

Sets the H.264 AVC level to avcLevel.

See also avcLevel().

void QAndroidMediaFormat::setAvcProfile(int avcProfile)

Sets the H.264 AVC profile to avcProfile.

See also avcProfile().

void QAndroidMediaFormat::setBitrate(int bitrate)

Sets the target bitrate (in bits per second) to bitrate.

See also bitrate().

void QAndroidMediaFormat::setCodecType(QAndroidMediaFormat::CodecType codecType)

Sets the video codec type to codecType.

See also codecType().

void QAndroidMediaFormat::setFramerate(float framerate)

Sets the video frame rate (in frames per second) to framerate.

See also framerate().

void QAndroidMediaFormat::setIFrameInterval(float iFrameInterval)

Sets the interval between I-frames (in seconds) to iFrameInterval.

See also iFrameInterval().

void QAndroidMediaFormat::setKeyValue(const QString &key, const QVariant &value)

Sets a generic format key key with value.

Generic format keys allow configuring Android MediaFormat parameters that are not exposed through dedicated properties. The value is stored as a QVariant and its type determines how it will be applied to the Android MediaCodec.

Format key names are defined in Android's MediaFormat class documentation.

Supported Types

The following types are supported:

• qint32 - 32-bit integers (e.g., priority, color-format)
• qint64 - 64-bit integers and size values (e.g., max-input-size, duration)
• float - Single-precision floating-point
• double - Double-precision floating-point
• QString - String values (e.g., MIME types)
• QByteArray - Binary buffers (e.g., codec-specific data)
• QRect - Rectangle values (e.g., crop rectangles)

Integer Type Selection

// Wrong - literal is qint32
format.setKeyValue("max-input-size", 1024000);

// Correct - explicit qint64 for size values
format.setKeyValue("max-input-size", qint64(1024000));

// Small values use qint32
format.setKeyValue("priority", 1);
format.setKeyValue("color-range", 2);

Common keys requiring qint64:

• max-input-size - Maximum input buffer size
• duration - Duration in microseconds

See also keyValue(), hasFormatKey(), and removeFormatKey().

void QAndroidMediaFormat::setOperatingRate(float operatingRate)

Sets the operating rate hint for the hardware encoder to operatingRate.

See also operatingRate().

void QAndroidMediaFormat::setSize(const QSize &size)

Sets the video resolution to size.

See also size().