# Enums

本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

#### AVErrorCode9+

Media错误码类型枚举。

**元服务API：** 从API version 11开始，该接口支持在元服务中使用。

**系统能力：** SystemCapability.Multimedia.Media.Core

| 名称 | 值 | 说明 |
| --- | --- | --- |
| AVERR_OK | 0 | 表示操作成功。 |
| AVERR_NO_PERMISSION | 201 | 表示无权限执行此操作。 |
| AVERR_INVALID_PARAMETER | 401 | 表示传入参数无效。 |
| AVERR_UNSUPPORT_CAPABILITY | 801 | 表示当前版本不支持该API能力。 |
| AVERR_NO_MEMORY | 5400101 | 表示系统内存不足或服务数量达到上限。 |
| AVERR_OPERATE_NOT_PERMIT | 5400102 | 表示当前状态不允许或无权执行此操作。 |
| AVERR_IO | 5400103 | 表示数据流异常信息。 |
| AVERR_TIMEOUT | 5400104 | 表示系统或网络响应超时。 |
| AVERR_SERVICE_DIED | 5400105 | 表示服务进程死亡。 |
| AVERR_UNSUPPORT_FORMAT | 5400106 | 表示不支持当前媒体资源的格式。 |
| AVERR_AUDIO_INTERRUPTED11+ | 5400107 | 表示音频焦点被抢占。 |
| AVERR_IO_HOST_NOT_FOUND14+ | 5411001 | 表示解析或链接服务端地址错误。 元服务API： 从API version 14开始，该接口支持在元服务中使用。 |
| AVERR_IO_CONNECTION_TIMEOUT14+ | 5411002 | 表示网络连接超时。 元服务API： 从API version 14开始，该接口支持在元服务中使用。 |
| AVERR_IO_NETWORK_ABNORMAL14+ | 5411003 | 表示网络异常导致的数据或链路异常。 元服务API： 从API version 14开始，该接口支持在元服务中使用。 |
| AVERR_IO_NETWORK_UNAVAILABLE14+ | 5411004 | 表示网络被禁用。 元服务API： 从API version 14开始，该接口支持在元服务中使用。 |
| AVERR_IO_NO_PERMISSION14+ | 5411005 | 表示无访问权限。 元服务API： 从API version 14开始，该接口支持在元服务中使用。 |
| AVERR_IO_REQUEST_DENIED14+ | 5411006 | 表示客户端请求参数错误或超出处理能力。 元服务API： 从API version 14开始，该接口支持在元服务中使用。 |
| AVERR_IO_RESOURCE_NOT_FOUND14+ | 5411007 | 表示无可用网络资源。 元服务API： 从API version 14开始，该接口支持在元服务中使用。 |
| AVERR_IO_SSL_CLIENT_CERT_NEEDED14+ | 5411008 | 表示服务端校验客户端证书失败。 元服务API： 从API version 14开始，该接口支持在元服务中使用。 |
| AVERR_IO_SSL_CONNECTION_FAILED14+ | 5411009 | 表示SSL连接失败。 元服务API： 从API version 14开始，该接口支持在元服务中使用。 |
| AVERR_IO_SSL_SERVER_CERT_UNTRUSTED14+ | 5411010 | 表示客户端校验服务端证书失败。 元服务API： 从API version 14开始，该接口支持在元服务中使用。 |
| AVERR_IO_UNSUPPORTED_REQUEST14+ | 5411011 | 表示网络协议的原因导致请求不受支持。 元服务API： 从API version 14开始，该接口支持在元服务中使用。 |
| AVERR_SEEK_CONTINUOUS_UNSUPPORTED18+ | 5410002 | 表示不支持SEEK_CONTINUOUS模式的seek。 元服务API： 从API version 18开始，该接口支持在元服务中使用。 |
| AVERR_SUPER_RESOLUTION_UNSUPPORTED18+ | 5410003 | 表示不支持超分。 元服务API： 从API version 18开始，该接口支持在元服务中使用。 |
| AVERR_SUPER_RESOLUTION_NOT_ENABLED18+ | 5410004 | 表示未使能超分。 元服务API： 从API version 18开始，该接口支持在元服务中使用。 |
| AVERR_PARAMETER_OUT_OF_RANGE20+ | 5400108 | 表示参数超过取值范围。 元服务API： 从API version 20开始，该接口支持在元服务中使用。 |
| AVERR_IO_CLEARTEXT_NOT_PERMITTED23+ | 5411012 | 表示不允许HTTP明文访问。 元服务API： 从API version 23开始，该接口支持在元服务中使用。 |

#### MediaType8+

媒体类型枚举。

**系统能力：** SystemCapability.Multimedia.Media.Core

| 名称 | 值 | 说明 |
| --- | --- | --- |
| MEDIA_TYPE_UNSUPPORTED20+ | -1 | 表示未支持的类型。 元服务API： 从API version 20 开始，该接口支持在元服务中使用。 |
| MEDIA_TYPE_AUD | 0 | 表示音频。 元服务API： 从API version 11 开始，该接口支持在元服务中使用。 |
| MEDIA_TYPE_VID | 1 | 表示视频。 元服务API： 从API version 11 开始，该接口支持在元服务中使用。 |
| MEDIA_TYPE_SUBTITLE12+ | 2 | 表示字幕。 元服务API： 从API version 12 开始，该接口支持在元服务中使用。 |
| MEDIA_TYPE_ATTACHMENT20+ | 3 | 表示附件信息（如嵌入的外部文件）。 元服务API： 从API version 20 开始，该接口支持在元服务中使用。 |
| MEDIA_TYPE_DATA20+ | 4 | 表示数据。 元服务API： 从API version 20 开始，该接口支持在元服务中使用。 |
| MEDIA_TYPE_TIMED_METADATA20+ | 5 | 表示带时间戳的元数据。 元服务API： 从API version 20 开始，该接口支持在元服务中使用。 |
| MEDIA_TYPE_AUXILIARY20+ | 6 | 表示辅助（轨道）信息。 元服务API： 从API version 20 开始，该接口支持在元服务中使用。 |

#### CodecMimeType8+

Codec MIME类型枚举。

**系统能力：** SystemCapability.Multimedia.Media.Core

| 名称 | 值 | 说明 |
| --- | --- | --- |
| VIDEO_H263 | 'video/h263' | 表示视频/h263类型。 |
| VIDEO_AVC | 'video/avc' | 表示视频/avc类型。 元服务API： 从API version 22开始，该接口支持在元服务中使用。 |
| VIDEO_MPEG2 | 'video/mpeg2' | 表示视频/mpeg2类型。 |
| VIDEO_MPEG4 | 'video/mp4v-es' | 表示视频/mpeg4类型。 |
| VIDEO_VP8 | 'video/x-vnd.on2.vp8' | 表示视频/vp8类型。 |
| VIDEO_HEVC11+ | 'video/hevc' | 表示视频/H265类型。 元服务API： 从API version 22开始，该接口支持在元服务中使用。 |
| AUDIO_AAC | 'audio/mp4a-latm' | 表示音频/mp4a-latm类型。 元服务API： 从API version 12开始，该接口支持在元服务中使用。 |
| AUDIO_VORBIS | 'audio/vorbis' | 表示音频/vorbis类型。 |
| AUDIO_FLAC | 'audio/flac' | 表示音频/flac类型。 |
| AUDIO_MP312+ | 'audio/mpeg' | 表示音频/mpeg类型。 |
| AUDIO_G711MU12+ | 'audio/g711mu' | 表示音频/G711-mulaw类型。 |
| AUDIO_AMR_NB18+ | 'audio/3gpp' | 表示音频/amr-nb类型。 |
| AUDIO_AMR_WB18+ | 'audio/amr-wb' | 表示音频/amr-wb类型。 |

#### AacProfile22+

高级音频编码（AAC）类型枚举。

**元服务API：** 从API version 22开始，该接口支持在元服务中使用。

**系统能力：** SystemCapability.Multimedia.Media.AVRecorder

| 名称 | 值 | 说明 |
| --- | --- | --- |
| AAC_LC | 0 | 表示AAC Low-Complexity类型。 |
| AAC_HE | 1 | 表示AAC High-Efficiency类型。 |
| AAC_HE_V2 | 2 | 表示AAC High-Efficiency version 2类型。 |

#### MediaDescriptionKey8+

媒体信息描述枚举。

**系统能力：** SystemCapability.Multimedia.Media.Core

| 名称 | 值 | 说明 |
| --- | --- | --- |
| MD_KEY_TRACK_INDEX | 'track_index' | 表示轨道序号，其对应键值类型为number。 元服务API： 从API version 11开始，该接口支持在元服务中使用。 |
| MD_KEY_TRACK_TYPE | 'track_type' | 表示轨道类型，其对应键值类型为number，参考MediaType。 元服务API： 从API version 11开始，该接口支持在元服务中使用。 |
| MD_KEY_CODEC_MIME | 'codec_mime' | 表示codec_mime类型，其对应键值类型为string。 元服务API： 从API version 11开始，该接口支持在元服务中使用。 |
| MD_KEY_DURATION | 'duration' | 表示媒体时长，其对应键值类型为number，单位为毫秒（ms）。 元服务API： 从API version 11开始，该接口支持在元服务中使用。 |
| MD_KEY_BITRATE | 'bitrate' | 表示比特率，其对应键值类型为number，单位为比特率（bps），值为undefined或0表示异常。 元服务API： 从API version 11开始，该接口支持在元服务中使用。 |
| MD_KEY_WIDTH | 'width' | 表示视频宽度，其对应键值类型为number，单位为像素（px）。 元服务API： 从API version 11开始，该接口支持在元服务中使用。 |
| MD_KEY_HEIGHT | 'height' | 表示视频高度，其对应键值类型为number，单位为像素（px）。 元服务API： 从API version 11开始，该接口支持在元服务中使用。 |
| MD_KEY_FRAME_RATE | 'frame_rate' | 表示视频帧率，其对应键值类型为number，单位为每100秒的帧数。 元服务API： 从API version 11开始，该接口支持在元服务中使用。 |
| MD_KEY_AUD_CHANNEL_COUNT | 'channel_count' | 表示声道数，其对应键值类型为number。 元服务API： 从API version 11开始，该接口支持在元服务中使用。 |
| MD_KEY_AUD_SAMPLE_RATE | 'sample_rate' | 表示采样率，其对应键值类型为number，单位为赫兹（Hz）。 元服务API： 从API version 11开始，该接口支持在元服务中使用。 |
| MD_KEY_AUD_SAMPLE_DEPTH12+ | 'sample_depth' | 表示位深，其对应键值类型为number，单位为位（bit）。 元服务API： 从API version 12开始，该接口支持在元服务中使用。 |
| MD_KEY_LANGUAGE12+ | 'language' | 表示字幕语言，其对应键值类型为string。 元服务API： 从API version 12开始，该接口支持在元服务中使用。 |
| MD_KEY_TRACK_NAME12+ | 'track_name' | 表示track名称，其对应键值类型为string。 元服务API： 从API version 12开始，该接口支持在元服务中使用。 |
| MD_KEY_HDR_TYPE12+ | 'hdr_type' | 表示视频轨类型，其对应键值类型为string。 元服务API： 从API version 12开始，该接口支持在元服务中使用。 |
| MD_KEY_ORIGINAL_WIDTH21+ | 'original_width' | 表示视频原始宽度，其对应键值类型为number，单位为像素（px）。 元服务API： 从API version 21开始，该接口支持在元服务中使用。 |
| MD_KEY_ORIGINAL_HEIGHT21+ | 'original_height' | 表示视频原始高度，其对应键值类型为number，单位为像素（px）。 元服务API： 从API version 21开始，该接口支持在元服务中使用。 |
| MD_KEY_MIME_TYPE23+ | 'mime_type' | 表示轨道的mime_type类型，其对应键值类型为string。对于音视频轨道，该值与MD_KEY_CODEC_MIME相同。 元服务API： 从API version 23开始，该接口支持在元服务中使用。 |
| MD_KEY_REFERENCE_TRACK_IDS23+ | 'ref_track_ids' | 表示此轨道与其他轨道的引用关系，其对应键值类型为string，以逗号分隔。 元服务API： 从API version 23开始，该接口支持在元服务中使用。 |
| MD_KEY_TRACK_REFERENCE_TYPE23+ | 'track_ref_type' | 表示此轨道作为辅助轨的辅助类型，其对应键值类型为string。 元服务API： 从API version 23开始，该接口支持在元服务中使用。 |

#### FetchResult23+

表示批量获取缩略图操作结果的枚举。

**模型约束：** 此接口仅可在Stage模型下使用。

**系统能力：** SystemCapability.Multimedia.Media.AVMetadataExtractor

| 名称 | 值 | 说明 |
| --- | --- | --- |
| FETCH_FAILED | 0 | 从视频中获取该缩略图失败。 |
| FETCH_SUCCEEDED | 1 | 从视频中获取该缩略图成功。 |
| FETCH_CANCELED | 2 | 从视频中获取该缩略图操作被取消。 |

#### PlaybackInfoKey12+

播放信息描述枚举。

**系统能力：** SystemCapability.Multimedia.Media.Core

| 名称 | 值 | 说明 |
| --- | --- | --- |
| SERVER_IP_ADDRESS | 'server_ip_address' | 表示服务器IP地址，其对应键值类型为string。 |
| AVG_DOWNLOAD_RATE | 'average_download_rate' | 表示平均下载速率，其对应键值类型为number，单位为比特率（bps）。 |
| DOWNLOAD_RATE | 'download_rate' | 表示1s的下载速率，其对应键值类型为number，单位为比特率（bps）。 |
| IS_DOWNLOADING | 'is_downloading' | 表示下载状态，1表示在下载状态，0表示非下载状态（下载完成），其对应键值类型为number。 |
| BUFFER_DURATION | 'buffer_duration' | 表示缓存数据的可播放时长，其对应键值类型为number，单位为秒（s）。 |

#### PlaybackMetricsKey23+

表示播放器指标信息的枚举。

**系统能力：** SystemCapability.Multimedia.Media.AVPlayer

| 名称 | 值 | 说明 |
| --- | --- | --- |
| PREPARE_DURATION | 'prepare_duration' | 表示准备时长，单位为毫秒（ms）。 |
| RESOURCE_CONNECTION_DURATION | 'resource_connection_duration' | 表示资源建链时长，单位为毫秒（ms）。 |
| FIRST_FRAME_DECAPSULATION_DURATION | 'first_frame_decapsulation_duration' | 表示第一帧的解封装时长，单位为毫秒（ms）。 |
| TOTAL_PLAYING_TIME | 'total_playback_time' | 表示总的播放时长，单位为毫秒（ms）。 |
| DOWNLOAD_REQUESTS_COUNT | 'loading_requests_count' | 表示总的请求次数。 模型约束： 此接口仅可在Stage模型下使用。 |
| TOTAL_DOWNLOAD_TIME | 'total_loading_time' | 表示总的加载时长，单位为毫秒（ms）。 |
| TOTAL_DOWNLOAD_SIZE | 'total_loading_bytes' | 表示总的加载大小，单位为字节（Byte）。 模型约束： 此接口仅可在Stage模型下使用。 |
| STALLING_COUNT | 'stalling_count' | 表示总的卡顿次数。 |
| TOTAL_STALLING_TIME | 'total_stalling_time' | 表示总的卡顿时长，单位为毫秒（ms）。 |

#### BufferingInfoType8+

缓存事件类型枚举。

**元服务API：** 从API version 12开始，该接口支持在元服务中使用。

**系统能力：** SystemCapability.Multimedia.Media.Core

| 名称 | 值 | 说明 |
| --- | --- | --- |
| BUFFERING_START | 1 | 表示开始缓冲。当上报BUFFERING_START时，播放器会暂停播放。 元服务API： 从API version 12开始，该接口支持在元服务中使用。 |
| BUFFERING_END | 2 | 表示结束缓冲。当上报BUFFERING_END时，播放器会恢复播放。 元服务API： 从API version 12开始，该接口支持在元服务中使用。 |
| BUFFERING_PERCENT | 3 | 表示缓冲百分比。可参考该事件感知缓冲进度。 元服务API： 从API version 12开始，该接口支持在元服务中使用。 |
| CACHED_DURATION | 4 | 表示已缓冲数据预估可播放时长，单位为毫秒（ms）。缓冲区中的数据变化量大于500ms，上报一次。可参考该事件做进度条。 元服务API： 从API version 12开始，该接口支持在元服务中使用。 |

#### SoundInterruptMode23+

表示在SoundPool中，同一ID的音频在播放时的打断模式的枚举。

**模型约束：** 此接口仅可在Stage模型下使用。

**系统能力：** SystemCapability.Multimedia.Media.SoundPool

| 名称 | 值 | 说明 |
| --- | --- | --- |
| NO_INTERRUPT | 0 | 表示同一ID的音频，如果前者尚未播放完成，后者不会打断前者的播放，二者并行播放。 |
| SAME_SOUND_INTERRUPT | 1 | 表示同一ID的音频，如果前者尚未播放完成，后者在播放前会先打断前者的播放。 |

#### StateChangeReason9+

表示播放或录制实例状态机切换原因的枚举，伴随state一起上报。

**元服务API：** 从API version 11开始，该接口支持在元服务中使用。

**系统能力：** SystemCapability.Multimedia.Media.Core

| 名称 | 值 | 说明 |
| --- | --- | --- |
| USER | 1 | 表示用户行为造成的状态切换，由用户或客户端主动调用接口产生。 |
| BACKGROUND | 2 | 表示后台系统行为造成的状态切换，比如应用未注册播控中心权限，退到后台时被系统强制暂停或停止。 |

#### SeekMode8+

视频播放的Seek模式枚举，可通过seek方法作为参数传递下去。

**系统能力：** SystemCapability.Multimedia.Media.Core

| 名称 | 值 | 说明 |
| --- | --- | --- |
| SEEK_NEXT_SYNC | 0 | 表示跳转到指定时间点的下一个关键帧，建议向后快进的时候用这个枚举值。 元服务API： 从API version 11开始，该接口支持在元服务中使用。 |
| SEEK_PREV_SYNC | 1 | 表示跳转到指定时间点的上一个关键帧，建议向前快进的时候用这个枚举值。 元服务API： 从API version 11开始，该接口支持在元服务中使用。 |
| SEEK_CLOSEST12+ | 2 | 表示跳转到距离指定时间点最近的帧，建议精准跳转进度的时候用这个枚举值。 元服务API： 从API version 12开始，该接口支持在元服务中使用。 |
| SEEK_CONTINUOUS18+ | 3 | 该模式提供了一种画面平滑流畅变化的Seek体验，应用可以结合进度条控件持续调用Seek方法，AVPlayer根据Seek调用持续流畅地更新画面。 应用可以调用isSeekContinuousSupported方法根据返回结果感知视频源是否支持该模式Seek。 对于不支持该Seek模式的视频源调用该模式Seek时，会上报AVERR_SEEK_CONTINUOUS_UNSUPPORTED错误(参考AVErrorCode)，同时画面更新的流畅性会降低。 该Seek模式不会触发on('seekDone')事件。 当应用需要退出该模式下的Seek时，需要调用seek(-1, SeekMode.SEEK_CONTINUOUS)来结束该模式下的Seek。 元服务API： 从API version 18开始，该接口支持在元服务中使用。 |

#### SwitchMode12+

表示视频播放的selectTrack模式枚举。

可通过selectTrack方法作为参数传递下去，当前DASH/HLS协议视频轨均支持该扩展参数（从API版本26.0.0开始HLS协议视频轨支持该扩展参数）。

**系统能力：** SystemCapability.Multimedia.Media.Core

| 名称 | 值 | 说明 |
| --- | --- | --- |
| SMOOTH | 0 | 表示切换后视频平滑播放，该模式切换存在延迟，不会立即生效。 元服务API： 从API version 12开始，该接口支持在元服务中使用。 |
| SEGMENT | 1 | 表示切换后从当前分片开始位置播放，该模式立即切换，会有重复播放。 元服务API： 从API version 12开始，该接口支持在元服务中使用。 |
| CLOSEST | 2 | 表示从距离当前播放时间点最近的帧开始播放，该模式立即切换，切换后会卡住3到5s，然后恢复播放。 元服务API： 从API version 12开始，该接口支持在元服务中使用。 |

#### PlaybackSpeed8+

视频播放的倍速枚举，可通过setSpeed方法作为参数传递下去。

**元服务API：** 从API version 12开始，该接口支持在元服务中使用。

**系统能力：** SystemCapability.Multimedia.Media.VideoPlayer

| 名称 | 值 | 说明 |
| --- | --- | --- |
| SPEED_FORWARD_0_75_X | 0 | 表示视频播放正常播速的0.75倍。 元服务API： 从API version 12开始，该接口支持在元服务中使用。 |
| SPEED_FORWARD_1_00_X | 1 | 表示视频播放正常播速。 元服务API： 从API version 12开始，该接口支持在元服务中使用。 |
| SPEED_FORWARD_1_25_X | 2 | 表示视频播放正常播速的1.25倍。 元服务API： 从API version 12开始，该接口支持在元服务中使用。 |
| SPEED_FORWARD_1_75_X | 3 | 表示视频播放正常播速的1.75倍。 元服务API： 从API version 12开始，该接口支持在元服务中使用。 |
| SPEED_FORWARD_2_00_X | 4 | 表示视频播放正常播速的2.00倍。 元服务API： 从API version 12开始，该接口支持在元服务中使用。 |
| SPEED_FORWARD_0_50_X12+ | 5 | 表示视频播放正常播速的0.50倍。 元服务API： 从API version 12开始，该接口支持在元服务中使用。 |
| SPEED_FORWARD_1_50_X12+ | 6 | 表示视频播放正常播速的1.50倍。 元服务API： 从API version 12开始，该接口支持在元服务中使用。 |
| SPEED_FORWARD_3_00_X13+ | 7 | 表示视频播放正常播速的3.00倍。 元服务API： 从API version 13开始，该接口支持在元服务中使用。 |
| SPEED_FORWARD_0_25_X12+ | 8 | 表示视频播放正常播速的0.25倍。 元服务API： 从API version 12开始，该接口支持在元服务中使用。 |
| SPEED_FORWARD_0_125_X12+ | 9 | 表示视频播放正常播速的0.125倍。 元服务API： 从API version 12开始，该接口支持在元服务中使用。 |

#### VideoScaleType9+

枚举，视频缩放模式。

**元服务API：** 从API version 12开始，该接口支持在元服务中使用。

**系统能力：** SystemCapability.Multimedia.Media.VideoPlayer

| 名称 | 值 | 说明 |
| --- | --- | --- |
| VIDEO_SCALE_TYPE_FIT | 0 | 默认比例类型，视频拉伸至与窗口等大。 |
| VIDEO_SCALE_TYPE_FIT_CROP | 1 | 保持视频宽高比缩放至最短边填满窗口，长边超出窗口部分被裁剪。 |
| VIDEO_SCALE_TYPE_SCALED_ASPECT20+ | 2 | 保持视频宽高比缩放至长边填满窗口，短边居中对齐，未填满部分留黑。 元服务API： 从API version 20开始，该接口支持在元服务中使用。 |

#### AudioSourceType9+

表示视频录制中音频源类型的枚举。

**系统能力：** SystemCapability.Multimedia.Media.AVRecorder

| 名称 | 值 | 说明 |
| --- | --- | --- |
| AUDIO_SOURCE_TYPE_DEFAULT | 0 | 默认的音频输入源类型。 |
| AUDIO_SOURCE_TYPE_MIC | 1 | 表示MIC的音频输入源。 元服务API： 从API version 12 开始，该接口支持在元服务中使用。 |
| AUDIO_SOURCE_TYPE_VOICE_RECOGNITION12+ | 2 | 表示语音识别场景的音频源。 |
| AUDIO_SOURCE_TYPE_VOICE_COMMUNICATION12+ | 7 | 表示语音通话场景的音频源。 |
| AUDIO_SOURCE_TYPE_VOICE_MESSAGE12+ | 10 | 表示短语音消息的音频源。 |
| AUDIO_SOURCE_TYPE_CAMCORDER12+ | 13 | 表示相机录像的音频源。 |

#### VideoSourceType9+

表示视频录制中视频源类型的枚举。

**系统能力：** SystemCapability.Multimedia.Media.AVRecorder

| 名称 | 值 | 说明 |
| --- | --- | --- |
| VIDEO_SOURCE_TYPE_SURFACE_YUV | 0 | 输入surface中携带的是raw data。 |
| VIDEO_SOURCE_TYPE_SURFACE_ES | 1 | 输入surface中携带的是ES data。 |

#### ContainerFormatType8+

表示容器格式类型的枚举，缩写为CFT。

**系统能力：** SystemCapability.Multimedia.Media.Core

| 名称 | 值 | 说明 |
| --- | --- | --- |
| CFT_MPEG_4 | 'mp4' | 视频的容器格式，MP4。 元服务API： 从API version 22开始，该接口支持在元服务中使用。 |
| CFT_MPEG_4A | 'm4a' | 音频的容器格式，M4A。 元服务API： 从API version 12开始，该接口支持在元服务中使用。 |
| CFT_MP312+ | 'mp3' | 音频的容器格式，MP3。 |
| CFT_WAV12+ | 'wav' | 音频的容器格式，WAV。 |
| CFT_AMR18+ | 'amr' | 音频的容器格式，AMR。 |
| CFT_AAC20+ | 'aac' | 音频的容器格式，AAC。默认为ADTS帧头格式。 |

#### FileGenerationMode12+

表示创建媒体文件模式的枚举。

**系统能力：** SystemCapability.Multimedia.Media.AVRecorder

| 名称 | 值 | 说明 |
| --- | --- | --- |
| APP_CREATE | 0 | 由应用自行在沙箱创建媒体文件。 |
| AUTO_CREATE_CAMERA_SCENE | 1 | 由系统创建媒体文件，当前仅在相机录制场景下生效，会忽略应用设置的url。 |

#### HdrType12+

表示视频HDR类型的枚举。

**系统能力：** SystemCapability.Multimedia.Media.Core

| 名称 | 值 | 说明 |
| --- | --- | --- |
| AV_HDR_TYPE_NONE | 0 | 表示无HDR类型。 |
| AV_HDR_TYPE_VIVID | 1 | 表示为HDR VIVID类型。 |

#### AVImageQueryOptions12+

需要获取的缩略图时间点与视频帧的对应关系。

在获取视频缩略图时，传入的时间点与实际取得的视频帧所在时间点不一定相等，需要指定传入的时间点与实际取得的视频帧的时间关系。

**系统能力：** SystemCapability.Multimedia.Media.AVImageGenerator

| 名称 | 值 | 说明 |
| --- | --- | --- |
| AV_IMAGE_QUERY_NEXT_SYNC | 0 | 表示选取传入时间点或之后的关键帧。 |
| AV_IMAGE_QUERY_PREVIOUS_SYNC | 1 | 表示选取传入时间点或之前的关键帧。 |
| AV_IMAGE_QUERY_CLOSEST_SYNC | 2 | 表示选取离传入时间点最近的关键帧。 |
| AV_IMAGE_QUERY_CLOSEST | 3 | 表示选取离传入时间点最近的帧，该帧不一定是关键帧。 |

#### LoadingRequestError18+

枚举，数据加载过程中状态变化的原因。

**元服务API：** 从API version 18开始，该接口支持在元服务中使用。

**系统能力：** SystemCapability.Multimedia.Media.Core

| 名称 | 值 | 说明 |
| --- | --- | --- |
| LOADING_ERROR_SUCCESS | 0 | 由客户端返回，表示已经推送到资源末尾。 |
| LOADING_ERROR_NOT_READY | 1 | 由客户端返回，表示资源尚未准备好可供访问。 |
| LOADING_ERROR_NO_RESOURCE | 2 | 由客户端返回，表示请求的资源URL不存在。 |
| LOADING_ERROR_INVAID_HANDLE | 3 | 由客户端返回，表示请求的资源句柄uuid无效。 |
| LOADING_ERROR_ACCESS_DENIED | 4 | 由客户端返回，表示客户端没有权限请求该资源。 |
| LOADING_ERROR_ACCESS_TIMEOUT | 5 | 由客户端返回，表示访问资源过程超时。 |
| LOADING_ERROR_AUTHORIZE_FAILED | 6 | 由客户端返回，表示授权失败。 |

#### AVMimeTypes12+

媒体MIME类型，通过setMimeType设置。

**元服务API：** 从API version 12开始，该接口支持在元服务中使用。

**系统能力：** SystemCapability.Multimedia.Media.Core

| 名称 | 值 | 说明 |
| --- | --- | --- |
| APPLICATION_M3U8 | application/m3u8 | 表示m3u8本地文件。 |

#### AVScreenCaptureRecordPreset12+

进行屏幕录制时的编码、封装格式参数的枚举。

**系统能力：** SystemCapability.Multimedia.Media.AVScreenCapture

| 名称 | 值 | 说明 |
| --- | --- | --- |
| SCREEN_RECORD_PRESET_H264_AAC_MP4 | 0 | 使用视频H264编码，音频AAC编码，MP4封装格式。 |
| SCREEN_RECORD_PRESET_H265_AAC_MP4 | 1 | 使用视频H265编码，音频AAC编码，MP4封装格式。 |

#### AVScreenCaptureStateCode12+

屏幕录制的状态回调。

**系统能力：** SystemCapability.Multimedia.Media.AVScreenCapture

| 名称 | 值 | 说明 |
| --- | --- | --- |
| SCREENCAPTURE_STATE_STARTED | 0 | 录屏已开始。 |
| SCREENCAPTURE_STATE_CANCELED | 1 | 录屏被取消。 |
| SCREENCAPTURE_STATE_STOPPED_BY_USER | 2 | 录屏被用户手动停止。 |
| SCREENCAPTURE_STATE_INTERRUPTED_BY_OTHER | 3 | 录屏被其他录屏打断。 |
| SCREENCAPTURE_STATE_STOPPED_BY_CALL | 4 | 录屏被来电打断。 |
| SCREENCAPTURE_STATE_MIC_UNAVAILABLE | 5 | 录屏无法使用麦克风收音。 |
| SCREENCAPTURE_STATE_MIC_MUTED_BY_USER | 6 | 麦克风被用户关闭。 |
| SCREENCAPTURE_STATE_MIC_UNMUTED_BY_USER | 7 | 麦克风被用户打开。 |
| SCREENCAPTURE_STATE_ENTER_PRIVATE_SCENE | 8 | 录屏进入隐私页面。 |
| SCREENCAPTURE_STATE_EXIT_PRIVATE_SCENE | 9 | 录屏退出隐私页面。 |
| SCREENCAPTURE_STATE_STOPPED_BY_USER_SWITCHES | 10 | 系统用户切换，录屏中断。 |
| SCREENCAPTURE_STATE_PAUSED_BY_USER | 11 | 录屏已被用户暂停。 起始版本： 26.0.0 模型约束： 此接口仅可在Stage模型下使用。 |
| SCREENCAPTURE_STATE_RESUMED_BY_USER | 12 | 录屏已被用户恢复。 起始版本： 26.0.0 模型约束： 此接口仅可在Stage模型下使用。 |
| SCREENCAPTURE_STATE_PAUSED_BY_APP | 13 | 录屏已被应用程序暂停。 起始版本： 26.0.0 模型约束： 此接口仅可在Stage模型下使用。 |
| SCREENCAPTURE_STATE_RESUMED_BY_APP | 14 | 录屏已被应用程序恢复。 起始版本： 26.0.0 模型约束： 此接口仅可在Stage模型下使用。 |

#### AVScreenCaptureFillMode18+

进行屏幕录制时视频填充模式的枚举。

**系统能力：** SystemCapability.Multimedia.Media.AVScreenCapture

| 名称 | 值 | 说明 |
| --- | --- | --- |
| PRESERVE_ASPECT_RATIO | 0 | 保持与原始图像相同的宽高比例，即与物理屏幕宽高比例一致。 |
| SCALE_TO_FILL | 1 | 进行图像拉伸填充，适配设置的宽度和高度。 |

#### PickerMode22+

表示屏幕录制Picker模式的枚举。

**系统能力：** SystemCapability.Multimedia.Media.AVScreenCapture

| 名称 | 值 | 说明 |
| --- | --- | --- |
| WINDOW_ONLY | 0 | 仅显示窗口列表。 |
| SCREEN_ONLY | 1 | 仅显示屏幕列表。 |
| SCREEN_AND_WINDOW | 2 | 同时显示屏幕列表和窗口列表。 |
| APP_ONLY | 3 | 仅显示应用模式。 起始版本： 26.0.0 模型约束： 此接口仅可在Stage模型下使用。 |
| WINDOW_AND_APP | 4 | 同时显示窗口和应用模式。 起始版本： 26.0.0 模型约束： 此接口仅可在Stage模型下使用。 |
| SCREEN_AND_APP | 5 | 同时显示屏幕和应用模式。 起始版本： 26.0.0 模型约束： 此接口仅可在Stage模型下使用。 |
| SCREEN_WINDOW_AND_APP | 6 | 同时显示屏幕、窗口和应用模式。 起始版本： 26.0.0 模型约束： 此接口仅可在Stage模型下使用。 |

#### AVMetricsEventType23+

表示媒体服务支持的指标事件的枚举。

**系统能力：** SystemCapability.Multimedia.Media.Core

| 名称 | 值 | 说明 |
| --- | --- | --- |
| AV_METRICS_EVENT_STALLING | 1 | 表示播放卡顿的指标事件。 |

#### PlaylistLoopMode

表示播放列表循环模式的枚举。

**起始版本：** 26.0.0

**元服务API：** 从API版本26.0.0开始，该接口支持在元服务中使用。

**模型约束：** 此接口仅可在Stage模型下使用。

**系统能力：** SystemCapability.Multimedia.Media.Core

| 名称 | 值 | 说明 |
| --- | --- | --- |
| PLAYLIST_LOOP_MODE_ALL | 1 | 列表循环模式。 |
| PLAYLIST_LOOP_MODE_ONE | 2 | 单曲循环模式。 |
| PLAYLIST_LOOP_MODE_SHUFFLE | 3 | 随机循环模式。 |
| PLAYLIST_LOOP_MODE_NONE | 4 | 关闭循环模式。 |

#### AudioEncoder(deprecated)

从API version 6开始支持，从API version 8开始废弃，建议使用CodecMimeType替代。

表示音频编码格式的枚举。

**系统能力：** SystemCapability.Multimedia.Media.AudioRecorder

| 名称 | 值 | 说明 |
| --- | --- | --- |
| DEFAULT | 0 | 默认编码格式。 仅做接口定义，暂不支持使用。 说明： 从API version 6开始支持，从API version 8开始废弃，建议使用CodecMimeType中的AUDIO_AAC替代。 |
| AMR_NB | 1 | AMR-NB(Adaptive Multi Rate-Narrow Band Speech Codec) 编码格式。 仅做接口定义，暂不支持使用。 说明： 从API version 6开始支持，从API version 8开始废弃，建议使用CodecMimeType中的AUDIO_AMR_NB替代。 |
| AMR_WB | 2 | AMR-WB(Adaptive Multi Rate-Wide Band Speech Codec) 编码格式。 仅做接口定义，暂不支持使用。 说明： 从API version 6开始支持，从API version 8开始废弃，建议使用CodecMimeType中的AUDIO_AMR_WB替代。 |
| AAC_LC | 3 | AAC-LC（Advanced Audio Coding Low Complexity）编码格式。 说明： 从API version 6开始支持，从API version 8开始废弃，建议使用CodecMimeType中的AUDIO_AAC替代。 |
| HE_AAC | 4 | HE_AAC（High-Efficiency Advanced Audio Coding）编码格式。 仅做接口定义，暂不支持使用。 说明： 从API version 6开始支持，从API version 8开始废弃，建议使用CodecMimeType中的AUDIO_AAC替代。 |

#### AudioOutputFormat(deprecated)

从API version 6开始支持，从API version 8 开始废弃，建议使用ContainerFormatType替代。

表示音频封装格式的枚举。

**系统能力：** SystemCapability.Multimedia.Media.AudioRecorder

| 名称 | 值 | 说明 |
| --- | --- | --- |
| DEFAULT | 0 | 默认封装格式。 仅做接口定义，暂不支持使用。 说明： 从API version 6开始支持，从API version 8开始废弃，建议根据具体情况选择ContainerFormatType中的一项替代。 |
| MPEG_4 | 2 | 封装为MPEG-4格式。 说明： 从API version 6开始支持，从API version 8开始废弃，建议使用ContainerFormatType中的CFT_MPEG_4替代。 |
| AMR_NB | 3 | 封装为AMR_NB格式。 仅做接口定义，暂不支持使用。 说明： 从API version 6开始支持，从API version 8开始废弃，建议使用ContainerFormatType中的CFT_AMR，编码格式使用CodecMimeType中的AUDIO_AMR_NB替代。 |
| AMR_WB | 4 | 封装为AMR_WB格式。 仅做接口定义，暂不支持使用。 说明： 从API version 6开始支持，从API version 8开始废弃，建议使用ContainerFormatType中的CFT_AMR，编码格式使用CodecMimeType中的AUDIO_AMR_WB替代。 |
| AAC_ADTS | 6 | 封装为ADTS（Audio Data Transport Stream）格式，是AAC音频的传输流格式。 说明： 从API version 6开始支持，从API version 8开始废弃，建议使用ContainerFormatType中的CFT_AAC替代。 |

#### MediaErrorCode(deprecated)

媒体服务错误类型枚举。

从API version 8开始支持，从API version 11开始废弃，建议使用AVErrorCode替代。

**系统能力：** SystemCapability.Multimedia.Media.Core

| 名称 | 值 | 说明 |
| --- | --- | --- |
| MSERR_OK | 0 | 表示操作成功。 |
| MSERR_NO_MEMORY | 1 | 表示申请内存失败，系统可能无可用内存。 |
| MSERR_OPERATION_NOT_PERMIT | 2 | 表示无权限执行此操作。 |
| MSERR_INVALID_VAL | 3 | 表示传入入参无效。 |
| MSERR_IO | 4 | 表示发生IO错误。 |
| MSERR_TIMEOUT | 5 | 表示操作超时。 |
| MSERR_UNKNOWN | 6 | 表示未知错误。 |
| MSERR_SERVICE_DIED | 7 | 表示服务端失效。 |
| MSERR_INVALID_STATE | 8 | 表示在当前状态下，不允许执行此操作。 |
| MSERR_UNSUPPORTED | 9 | 表示在当前版本下，不支持此操作。 |