harmony 鸿蒙Interfaces (其他)

2025-06-16
浏览 (2)

Interfaces (其他)

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

AVFileDescriptor⁹⁺

音视频文件资源描述，一种特殊资源的播放方式，使用场景：应用中的音频资源被连续存储在同一个文件中，需要根据偏移量和长度进行播放。

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

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

名称	类型	必填	说明
fd	number	是	资源句柄，通过resourceManager.getRawFd获取,也可以通过fs.open获取。
offset	number	否	资源偏移量，默认值为0，需要基于预置资源的信息输入，非法值会造成音视频资源解析错误。
length	number	否	资源长度，默认值为文件中从偏移量开始的剩余字节，需要基于预置资源的信息输入，非法值会造成音视频资源解析错误。

AVDataSrcDescriptor¹⁰⁺

音视频文件资源描述，用于DataSource播放方式，使用场景：应用在未获取完整音视频资源时，允许用户创建播放实例并开始播放，达到提前播放的目的。

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

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

名称	类型	必填	说明
fileSize	number	是	待播放文件大小（字节），-1代表大小未知。如果fileSize设置为-1, 播放模式类似于直播，不能进行seek及setSpeed操作，不能设置loop属性，因此不能重新播放。
callback	(buffer: ArrayBuffer, length: number, pos?: number) => number	是	用户设置的回调函数，用于填写数据。 - 函数列式：callback: (buffer: ArrayBuffer, length: number, pos?:number) => number; - buffer，ArrayBuffer类型，表示被填写的内存，必选。 - length，number类型，表示被填写内存的最大长度，必选。 - pos，number类型，表示填写的数据在资源文件中的位置，可选，当fileSize设置为-1时，该参数禁止被使用。 - 返回值，number类型，返回填充数据的长度，返回-1表示到达流的末尾，返回-2表示遇到不可恢复的错误。

SubtitleInfo¹²⁺

外挂字幕信息，使用场景：订阅外挂字幕事件，回调返回外挂字幕详细信息。

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

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

名称	类型	必填	说明
text	string	否	字幕文本信息。
startTime	number	否	显示当前字幕文本的开始时间（单位：毫秒）。
duration	number	否	显示当前字幕文本的持续时间（单位：毫秒）。

SeiMessage¹⁸⁺

SEI信息内容，描述SEI信息的负载类型和数据。

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

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

名称	类型	只读	可选	说明
payloadType	number	否	否	SEI信息的负载类型。
payload	ArrayBuffer	否	否	SEI信息的负载数据。

MediaDescription⁸⁺

通过key-value方式获取媒体信息。

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

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

名称	类型	必填	说明
[key: string]	Object	是	该键值对支持的key取值范围，请参考MediaDescriptionKey；每个key值的Object类型和范围，请参考MediaDescriptionKey对应Key值的说明。

示例：

import { BusinessError } from '@kit.BasicServicesKit';

function printfItemDescription(obj: media.MediaDescription, key: string) {
  let property: Object = obj[key];
  console.info('audio key is ' + key); // 通过key值获取对应的value。key值具体可见[MediaDescriptionKey](https://m.seaxiang.com/blog/bBzkOu)。
  console.info('audio value is ' + property); //对应key值得value。其类型可为任意类型，具体key对应value的类型可参考[MediaDescriptionKey](https://m.seaxiang.com/blog/bBzkOu)。
}

let avPlayer: media.AVPlayer|undefined = undefined;
media.createAVPlayer((err: BusinessError, player: media.AVPlayer) => {
  if(player != null) {
    avPlayer = player;
    console.info(`Succeeded in creating AVPlayer`);
    avPlayer.getTrackDescription((error: BusinessError, arrList: Array<media.MediaDescription>) => {
      if (arrList != null) {
        for (let i = 0; i < arrList.length; i++) {
          printfItemDescription(arrList[i], media.MediaDescriptionKey.MD_KEY_TRACK_TYPE);  //打印出每条轨道MD_KEY_TRACK_TYPE的值。
        }
      } else {
        console.error(`Failed to get TrackDescription, error:${error}`);
      }
    });
  } else {
    console.error(`Failed to create AVPlayer, error message:${err.message}`);
  }
});

PlaybackInfo¹²⁺

通过key-value方式获取播放信息。

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

名称	类型	必填	说明
[key: string]	Object	是	该键值对支持的key取值范围，请参考PlaybackInfoKey;每个key值的Object类型和范围，请参考PlaybackInfoKey对应Key值的说明。

AVRecorderConfig⁹⁺

表示音视频录制的参数设置。

通过audioSourceType和videoSourceType区分纯音频录制、纯视频录制或音视频录制。纯音频录制时，仅需要设置audioSourceType；纯视频录制时，仅需要设置videoSourceType；音视频录制时，audioSourceType和videoSourceType均需要设置。

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

名称	类型	必填	说明
audioSourceType	AudioSourceType	否	选择录制的音频源类型。选择音频录制时必填。原子化服务API：从API version 12 开始，该接口支持在原子化服务中使用。
videoSourceType	VideoSourceType	否	选择录制的视频源类型。选择视频录制时必填。
profile	AVRecorderProfile	是	录制的profile，必要参数。原子化服务API：从API version 12 开始，该接口支持在原子化服务中使用。
url	string	是	录制输出URL：fd://xx (fd number) ，必要参数。原子化服务API：从API version 12 开始，该接口支持在原子化服务中使用。
fileGenerationMode¹²⁺	FileGenerationMode	否	创建媒体文件的模式，配合on(‘photoAssetAvailable’)监听使用。
rotation^(deprecated)	number	否	录制的视频旋转角度，mp4格式支持0，90，180，270，默认值为0。从API version 6开始支持，从API version 12开始废弃。建议使用AVMetadata.videoOrientation替代。如果同时设置两个值，将会采用AVMetadata.videoOrientation。
location^(deprecated)	Location	否	录制的地理位置，默认不记录地理位置信息。从API version 6开始支持，从API version 12开始废弃。建议使用 AVMetadata.location。如果同时设置两个值，将会采用AVMetadata.location。
metadata¹²⁺	AVMetadata	否	设置元数据信息。详情见 AVMetadata。
maxDuration¹⁸⁺	number	否	设置录制的最大时长，单位为秒，有效值取值范围[1 , 2^31-1]，无效输入会重置为最大值。录制到达设定时长后，录制会自动停止，并通过stateChange回调录制状态，AVRecorderState = ‘stopped’，StateChangeReason = BACKGROUND。

AVRecorderProfile⁹⁺

音视频录制的配置文件。

说明： 此处提供音频参数配置的对照表，每项的具体释义，可查看下述字段解释。

编码格式封装格式采样率比特率声道数

AUDIO_AAC MP4,M4A [8000, 11025, 12000, 16000, 22050, 24000, 32000, 44100, 48000, 64000, 88200, 96000] [32000-500000] [1-8]

AUDIO_MP3 MP3 [8000, 11025, 12000, 16000, 22050, 24000, 32000, 44100, 48000]
- 采样率使用16000以下时，对应比特率范围为[8000 - 64000]。
- 采样率使用16000~32000时对应的比特率范围为[8000 - 160000]。
- 采样率使用32000以上时对应的比特率范围为[32000 - 320000]。 [1-2]

AUDIO_G711MU WAV [8000] [64000] [1]

AUDIO_AMR_NB¹⁸⁺ AMR [8000] [4750, 5150, 5900, 6700, 7400, 7950, 10200, 12200] [1]

AUDIO_AMR_WB¹⁸⁺ AMR [16000] [6600, 8850, 12650, 14250, 15850, 18250, 19850, 23050, 23850] [1]

编码格式	封装格式	采样率	比特率	声道数
AUDIO_AAC	MP4,M4A	[8000, 11025, 12000, 16000, 22050, 24000, 32000, 44100, 48000, 64000, 88200, 96000]	[32000-500000]	[1-8]
AUDIO_MP3	MP3	[8000, 11025, 12000, 16000, 22050, 24000, 32000, 44100, 48000]	- 采样率使用16000以下时，对应比特率范围为[8000 - 64000]。 - 采样率使用16000~32000时对应的比特率范围为[8000 - 160000]。 - 采样率使用32000以上时对应的比特率范围为[32000 - 320000]。	[1-2]
AUDIO_G711MU	WAV	[8000]	[64000]	[1]
AUDIO_AMR_NB¹⁸⁺	AMR	[8000]	[4750, 5150, 5900, 6700, 7400, 7950, 10200, 12200]	[1]
AUDIO_AMR_WB¹⁸⁺	AMR	[16000]	[6600, 8850, 12650, 14250, 15850, 18250, 19850, 23050, 23850]	[1]

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

名称	类型	必填	说明
audioBitrate	number	否	音频编码比特率，选择音频录制时必填。支持范围： - AAC编码格式支持比特率范围[32000 - 500000]。 - G711-mulaw编码格式支持比特率范围[64000]。 - MP3编码格式支持范围[8000, 16000, 32000, 40000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 160000, 192000, 224000, 256000, 320000]。当使用MP3编码格式时，采样率和比特率的映射关系： - 采样率使用16K以下时，对应比特率范围为[8000 - 64000]。 - 采样率使用16K~32K时对应的比特率范围为[8000 - 160000]。 - 采样率使用32K以上时对应的比特率范围为[32000 - 320000]。 - AMR_NB编码格式支持比特率范围[4750, 5150, 5900, 6700, 7400, 7950, 10200, 12200]。 - AMR_WB编码格式支持比特率范围[6600, 8850, 12650, 14250, 15850, 18250, 19850, 23050, 23850]。原子化服务API：从API version 12 开始，该接口支持在原子化服务中使用。
audioChannels	number	否	音频采集声道数，选择音频录制时必填。 - AAC编码格式支持范围[1 - 8]。 - G711-mulaw编码格式支持范围[1]。 - MP3编码格式支持范围[1 - 2]。 - AMR-NB、AMR-WB编码格式支持范围[1]。原子化服务API：从API version 12 开始，该接口支持在原子化服务中使用。
audioCodec	CodecMimeType	否	音频编码格式，选择音频录制时必填。当前支持AUDIO_AAC，AUDIO_MP3，AUDIO_G711MU, AUDIO_AMR_NB, AUDIO_AMR_WB。原子化服务API：从API version 12 开始，该接口支持在原子化服务中使用。
audioSampleRate	number	否	音频采样率，选择音频录制时必填。支持范围： - AAC编码支持采样率范围[8000, 11025, 12000, 16000, 22050, 24000, 32000, 44100, 48000, 64000, 88200, 96000]。 - G711-mulaw编码支持采样率范围[8000]。 - MP3编码支持采样率范围[8000, 11025, 12000, 16000, 22050, 24000, 32000, 44100, 48000]。 - AMR_NB编码支持采样率范围[8000]。 - AMR_WB编码支持采样率范围[16000]。可变比特率模式，码率仅作参考。原子化服务API：从API version 12 开始，该接口支持在原子化服务中使用。
fileFormat	ContainerFormatType	是	文件的容器格式，必要参数。当前支持MP4、M4A、MP3、WAV、AMR、AAC封装格式，当前AAC音频封装默认为ADTS帧头格式。不支持在MP4封装格式下使用AUDIO_MP3编码格式。原子化服务API：从API version 12 开始，该接口支持在原子化服务中使用。
videoBitrate	number	否	视频编码比特率，选择视频录制时必填，支持范围[10000 - 100000000]。
videoCodec	CodecMimeType	否	视频编码格式，选择视频录制时必填。当前支持VIDEO_AVC。
videoFrameWidth	number	否	视频帧的宽，选择视频录制时必填，支持范围[176 - 4096]。
videoFrameHeight	number	否	视频帧的高，选择视频录制时必填，支持范围[144 - 4096]。
videoFrameRate	number	否	视频帧率，选择视频录制时必填，推荐范围[1 - 60]。
isHdr¹¹⁺	boolean	否	HDR编码，选择视频录制时选填，isHdr默认为false，对应编码格式没有要求，isHdr为true时，对应的编码格式必须为video/hevc。
enableTemporalScale¹²⁺	boolean	否	视频录制是否支持时域分层编码功能，选择视频录制时选填，enableTemporalScale默认为false。设置为true时，编码输出的码流中部分帧可以支持跳过不编码。

Location

视频录制的地理位置。

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

名称	类型	必填	说明
latitude	number	是	地理位置的纬度，取值范围为[-90, 90]。
longitude	number	是	地理位置的经度，取值范围为[-180, 180]。

EncoderInfo¹¹⁺

编码器和规格参数。

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

名称	类型	可读	可写	说明
mimeType	CodecMimeType	是	否	编码器MIME类型名称。
type	string	是	否	编码器类型，audio表示音频编码器，video表示视频编码器。
bitRate	Range	是	否	比特率，包含该编码器的最大和最小值。
frameRate	Range	是	否	视频帧率，包含帧率的最大和最小值，仅视频编码器拥有。
width	Range	是	否	视频帧的宽度，包含宽度的最大和最小值，仅视频编码器拥有。
height	Range	是	否	视频帧的高度，包含高度的最大和最小值，仅视频编码器拥有。
channels	Range	是	否	音频采集声道数，包含声道数的最大和最小值，仅音频编码器拥有。
sampleRate	Array<number>	是	否	音频采样率，包含所有可以使用的音频采样率值数组，具体数值依赖编码器类型，仅音频编码器拥有。

Range¹¹⁺

表示一个类型的范围。

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

名称	类型	可读	可写	说明
min	number	是	否	范围的最小值。
max	number	是	否	范围的最大值。

AVTranscoderConfig¹²⁺

表示视频转码的参数设置。

系统能力： SystemCapability.Multimedia.Media.AVTranscoder

名称	类型	只读	可选	说明
audioBitrate	number	否	是	输出音频的码率，单位为比特率（bps），支持范围[1-500000]。默认设置为48Kbps。
audioCodec	CodecMimeType	否	是	输出音频的编码格式，当前仅支持AAC。默认设置为AAC。
fileFormat	ContainerFormatType	否	否	输出视频文件的封装格式，当前视频文件仅支持MP4。
videoBitrate	number	否	是	输出视频的码率，单位为比特率（bps）。默认码率按输出视频的分辨率设置，[240p，480P]默认码率值为1Mbps，(480P,720P]默认码率值为2Mbps，(720P,1080P]默认码率值为4Mbps，1080P及以上默认值为8Mbps。
videoCodec	CodecMimeType	否	是	输出视频的编码格式，当前仅支持AVC和HEVC。若源视频编码格式为HEVC，则默认设置为HEVC，否则默认设置为AVC。
videoFrameWidth	number	否	是	输出视频帧的宽，单位为像素（px），支持范围[240-3840]。默认设置为源视频帧的宽。
videoFrameHeight	number	否	是	输出视频帧的高，单位为像素（px），支持范围[240-2160]。默认设置为源视频帧的高。

AVMetadata¹¹⁺

音视频元数据，包含各个元数据字段。在AVRecorderConfig中使用时未声明为当前版本只读的参数可以作为使用AVRecorder录制时的入参。

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

名称	类型	必填	说明
album	string	否	专辑的标题。当前版本为只读参数。
albumArtist	string	否	专辑的艺术家。当前版本为只读参数。
artist	string	否	媒体资源的艺术家。当前版本为只读参数。
author	string	否	媒体资源的作者。当前版本为只读参数。
dateTime	string	否	媒体资源的创建时间。当前版本为只读参数。
dateTimeFormat	string	否	媒体资源的创建时间，按YYYY-MM-DD HH:mm:ss格式输出。当前版本为只读参数。
composer	string	否	媒体资源的作曲家。当前版本为只读参数。
duration	string	否	媒体资源的时长。当前版本为只读参数。
genre	string	否	媒体资源的类型或体裁。
hasAudio	string	否	媒体资源是否包含音频。当前版本为只读参数。
hasVideo	string	否	媒体资源是否包含视频。当前版本为只读参数。
mimeType	string	否	媒体资源的mime类型。当前版本为只读参数。
trackCount	string	否	媒体资源的轨道数量。当前版本为只读参数。
sampleRate	string	否	音频的采样率，单位为赫兹（Hz）。当前版本为只读参数。
title	string	否	媒体资源的标题。当前版本为只读参数。当前版本为只读参数。
videoHeight	string	否	视频的高度，单位为像素。当前版本为只读参数。
videoWidth	string	否	视频的宽度，单位为像素。当前版本为只读参数。
videoOrientation	string	否	视频的旋转方向，单位为度（°）。
hdrType¹²⁺	HdrType	否	媒体资源的HDR类型。当前版本为只读参数。
location¹²⁺	Location	否	视频的地理位置信息。
customInfo¹²⁺	Record	否	从moov.meta.list 获取的自定义参数键值映射。

PixelMapParams¹²⁺

获取视频缩略图时，输出缩略图的格式参数。

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

名称	类型	可读	可写	说明
width	number	是	是	输出的缩略图宽度。应保证大于0且不大于原始视频宽度。否则返回的缩略图不会进行缩放。
height	number	是	是	输出的缩略图高度。应保证大于0且不大于原始视频高度。否则返回的缩略图不会进行缩放。

OutputSize²⁰⁺

用于获取视频缩略图时，来定义输出图像大小。

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

名称	类型	只读	可选	说明
width	number	否	是	输出的缩略图宽度。 - 如果该值小于0，宽度是视频的原始宽度。 - 如果值为0或未分配任何值，缩放比例同高度比例。
height	number	否	是	输出的缩略图高度。 - 如果该值小于0，高度是视频的原始高度。 - 如果值为0或未分配任何值，缩放比例同宽度比例。

MediaStream¹⁹⁺

媒体流数据信息。

原子化服务API： 从API version 19开始，该接口支持在原子化服务中使用。

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

名称	类型	只读	可选	说明
url	string	否	否	媒体资源链接，当前仅支持http或者https。
width	number	否	否	媒体资源视频宽像素值。未知时可以填0，此时将无法通过PlaybackStrategy优选匹配。
height	number	否	否	媒体资源视频高像素值。未知时可以填0，此时将无法通过PlaybackStrategy优选匹配。
bitrate	number	否	否	媒体资源码率值，单位bps。

MediaSourceLoader¹⁸⁺

用于定义媒体数据加载器，需要应用程序对其进行实现。

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

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

名称	类型	必填	说明
open	SourceOpenCallback	是	由应用程序实现的回调函数，用于处理资源打开请求。
read	SourceReadCallback	是	由应用程序实现的回调函数，用于处理资源读取请求。
close	SourceCloseCallback	是	由应用程序实现的回调函数，用于处理资源关闭请求。

示例：

import HashMap from '@ohos.util.HashMap';

let headers: Record<string, string> = {"User-Agent" : "User-Agent-Value"};
let mediaSource : media.MediaSource = media.createMediaSourceWithUrl("http://xxx",  headers);
let uuid: number = 1;
let requests: HashMap<number, media.MediaSourceLoadingRequest> = new HashMap();
let mediaSourceLoader: media.MediaSourceLoader = {
  open: (request: media.MediaSourceLoadingRequest) => {
    console.log(`Opening resource: ${request.url}`);
    // 成功打开资源，返回唯一的句柄, 保证uuid和request对应。
    uuid += 1;
    requests.set(uuid, request);
    return uuid;
  },
  read: (uuid: number, requestedOffset: number, requestedLength: number) => {
    console.log(`Reading resource with handle ${uuid}, offset: ${requestedOffset}, length: ${requestedLength}`);
    // 判断uuid是否合法、存储read请求，不要在read请求阻塞去推送数据和头信息。
  },
  close: (uuid: number) => {
    console.log(`Closing resource with handle ${uuid}`);
    // 清除当前uuid相关资源。
    requests.remove(uuid);
  }
};

mediaSource.setMediaResourceLoaderDelegate(mediaSourceLoader);
let playStrategy : media.PlaybackStrategy = {
  preferredBufferDuration: 20,
};

async function setupPlayer() {
  let player = await media.createAVPlayer();
  player.setMediaSource(mediaSource, playStrategy);
}

PlaybackStrategy¹²⁺

播放策略。

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

名称	类型	必填	说明
preferredWidth	number	否	播放策略首选宽度，设置范围为大于0的整数，如1080，单位为像素（px）。原子化服务API：从API version 12开始，该接口支持在原子化服务中使用。
preferredHeight	number	否	播放策略首选高度，设置范围为大于0的整数，如1920，单位为像素（px）。原子化服务API：从API version 12开始，该接口支持在原子化服务中使用。
preferredBufferDuration	number	否	播放策略首选缓冲持续时间，单位s，取值范围1-20。具体使用方式可参考在线视频播放卡顿优化实践。原子化服务API：从API version 12开始，该接口支持在原子化服务中使用。
preferredHdr	boolean	否	播放策略true是hdr，false非hdr，默认非hdr。原子化服务API：从API version 12开始，该接口支持在原子化服务中使用。
enableSuperResolution¹⁸⁺	boolean	否	表示是否使能超分功能。true表示使能超分，false表示不使能超分，默认为false。若不使能超分，则后续不能调用超分相关接口。若使能超分，则超分功能默认开启，默认目标分辨率为1920x1080，单位为像素。原子化服务API：从API version 18开始，该接口支持在原子化服务中使用。
showFirstFrameOnPrepare¹⁷⁺	boolean	否	播放策略true是Prepare之后显示视频起播首帧，false是Prepare之后不显示视频起播首帧，默认不显示。原子化服务API：从API version 17开始，该接口支持在原子化服务中使用。
mutedMediaType	MediaType	否	静音播放的媒体类型，仅支持设置 MediaType.MEDIA_TYPE_AUD。
preferredAudioLanguage¹³⁺	string	否	播放策略首选音轨语言。dash场景下应用可按需设置。非dash场景暂不支持，建议缺省。原子化服务API：从API version 13开始，该接口支持在原子化服务中使用。
preferredSubtitleLanguage¹³⁺	string	否	播放策略首选字幕语言。dash场景下应用可按需设置。非dash场景暂不支持，建议缺省。原子化服务API：从API version 13开始，该接口支持在原子化服务中使用。
preferredBufferDurationForPlaying¹⁸⁺	number	否	播放策略首选起播缓冲水线。当起播缓冲时间超过该值，开始播放。单位s，取值范围0-20。原子化服务API：从API version 18开始，该接口支持在原子化服务中使用。
thresholdForAutoQuickPlay¹⁸⁺	number	否	智能追帧水线，单位为s，取值应不小于2s，且需大于起播缓冲水线，默认设置为5s。播放策略可以通过设置智能追帧水线来保证直播的实时性。flv直播场景下应用可按需设置，非flv直播场景暂不支持。网络状态的变化可能会导致播放器在某段时间内积压大量数据。播放器会定期检查当前播放时间与缓存中最新的帧时间戳之间的差值，当这个差值过大时，播放器将以1.2倍速开始智能追帧。speedDone事件会回调特定值100，表示智能追帧开启成功。当差值小于起播缓冲水线时，则停止追帧并恢复到正常播放速度。原子化服务API：从API version 18开始，该接口支持在原子化服务中使用。

AVScreenCaptureStrategy²⁰⁺

录屏策略。

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

名称	类型	必填	说明
keepCaptureDuringCall	boolean	否	蜂窝通话时是否保持录屏。

AVScreenCaptureRecordConfig¹²⁺

表示录屏参数配置。

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

名称	类型	必填	说明
fd	number	是	录制输出的文件fd。
frameWidth	number	否	录屏的视频宽度，默认屏幕宽度，根据不同屏幕默认值不同，单位px。
frameHeight	number	否	录屏的视频高度，默认屏幕高度，根据不同屏幕默认值不同，单位px。
videoBitrate	number	否	录屏的视频比特率，默认10000000。
audioSampleRate	number	否	录屏的音频采样率，内录的系统音和外录的麦克风都是用此采样率，默认48000，仅支持设置48000或16000。
audioChannelCount	number	否	录屏的音频通道数，内录的系统音和外录的麦克风都是用此通道数，默认2声道，仅支持设置1或2声道。
audioBitrate	number	否	录屏的音频比特率，内录的系统音和外录的麦克风都是用此比特率，默认96000。
preset	AVScreenCaptureRecordPreset	否	录屏使用的编码和封装格式，默认SCREEN_RECORD_PRESET_H264_AAC_MP4格式。
displayId¹⁵⁺	number	否	指定录屏使用的屏幕，默认主屏幕。
fillMode¹⁸⁺	AVScreenCaptureFillMode	否	录屏时视频流的填充模式。
strategy²⁰⁺	AVScreenCaptureStrategy	否	录屏策略。

AudioRecorderConfig^(deprecated)

说明： 从API version 6开始支持，从API version 9开始废弃，建议使用AVRecorderConfig替代。

表示音频的录音配置。

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

名称	类型	必填	说明
audioEncoder	AudioEncoder	否	音频编码格式，默认设置为AAC_LC。说明：从API version 8开始废弃，建议使用audioEncoderMime替代。
audioEncodeBitRate	number	否	音频编码比特率，默认值为48000。
audioSampleRate	number	否	音频采集采样率，默认值为48000。可变比特率模式，码率仅作参考。
numberOfChannels	number	否	音频采集声道数，默认值为2。
format	AudioOutputFormat	否	音频输出封装格式，默认设置为MPEG_4。说明：从API version 8开始废弃，建议使用fileFormat替代。
location	Location	否	音频采集的地理位置。
uri	string	是	音频输出URI：fd://xx (fd number) 文件需要由调用者创建，并赋予适当的权限。
audioEncoderMime⁸⁺	CodecMimeType	否	容器编码格式。
fileFormat⁸⁺	ContainerFormatType	否	音频编码格式。

你可能感兴趣的鸿蒙文章

harmony 鸿蒙Media Kit（媒体服务）

harmony 鸿蒙Interface (AVImageGenerator)

harmony 鸿蒙Interface (AVMetadataExtractor)

harmony 鸿蒙Interface (AVPlayer)

harmony 鸿蒙Interface (AVRecorder)

harmony 鸿蒙Interface (AVScreenCaptureRecorder)

harmony 鸿蒙Interface (AVTranscoder)

harmony 鸿蒙废弃的Interface (AudioPlayer, deprecated)

harmony 鸿蒙废弃的Interface (AudioRecorder, deprecated)

harmony 鸿蒙Interface (MediaSource)

0 赞

所属分类： 后端技术
本文标签： 软件鸿蒙
版权声明： 原创文章如转载，请注明本文链接: https://m.seaxiang.com/blog/iltCJv

harmony 鸿蒙Interfaces (其他)

Interfaces (其他)

AVFileDescriptor⁹⁺

AVDataSrcDescriptor¹⁰⁺

SubtitleInfo¹²⁺

SeiMessage¹⁸⁺

MediaDescription⁸⁺

PlaybackInfo¹²⁺

AVRecorderConfig⁹⁺

AVRecorderProfile⁹⁺

Location

EncoderInfo¹¹⁺

Range¹¹⁺

AVTranscoderConfig¹²⁺

AVMetadata¹¹⁺

PixelMapParams¹²⁺

OutputSize²⁰⁺

MediaStream¹⁹⁺

MediaSourceLoader¹⁸⁺

PlaybackStrategy¹²⁺

AVScreenCaptureStrategy²⁰⁺

AVScreenCaptureRecordConfig¹²⁺

AudioRecorderConfig^(deprecated)

你可能感兴趣的鸿蒙文章

热门推荐

标签云

最新文章

本文目录

harmony 鸿蒙Interfaces (其他)

Interfaces (其他)

AVFileDescriptor9+

AVDataSrcDescriptor10+

SubtitleInfo12+

SeiMessage18+

MediaDescription8+

PlaybackInfo12+

AVRecorderConfig9+

AVRecorderProfile9+

Location

EncoderInfo11+

Range11+

AVTranscoderConfig12+

AVMetadata11+

PixelMapParams12+

OutputSize20+

MediaStream19+

MediaSourceLoader18+

PlaybackStrategy12+

AVScreenCaptureStrategy20+

AVScreenCaptureRecordConfig12+

AudioRecorderConfig(deprecated)

你可能感兴趣的鸿蒙文章

热门推荐

标签云

最新文章

本文目录

AVFileDescriptor⁹⁺

AVDataSrcDescriptor¹⁰⁺

SubtitleInfo¹²⁺

SeiMessage¹⁸⁺

MediaDescription⁸⁺

PlaybackInfo¹²⁺

AVRecorderConfig⁹⁺

AVRecorderProfile⁹⁺

EncoderInfo¹¹⁺

Range¹¹⁺

AVTranscoderConfig¹²⁺

AVMetadata¹¹⁺

PixelMapParams¹²⁺

OutputSize²⁰⁺

MediaStream¹⁹⁺

MediaSourceLoader¹⁸⁺

PlaybackStrategy¹²⁺

AVScreenCaptureStrategy²⁰⁺

AVScreenCaptureRecordConfig¹²⁺

AudioRecorderConfig^(deprecated)