harmony 鸿蒙媒体子系统ChangeLog
媒体子系统ChangeLog
cl.media.1 播放功能接口变更
新增音视频播放接口AVPlayer9+， 升级了状态机和错误码，推荐用户使用。旧版音频播放接口AudioPlayer6+和视频播放接口VideoPlayer8+停止维护。
变更影响
原有的接口暂时可继续使用，但是停止维护，建议使用新接口进行开发。
关键的接口/组件变更
新增接口如下：
| 类名 | 新增接口声明 |
|---|---|
| media | createAVPlayer(callback: AsyncCallback<AVPlayer>): void |
| media | createAVPlayer() : Promise<AVPlayer> |
| media.AVPlayer | interface AVPlayer |
| media.AVPlayer | videoScaleType ?: VideoScaleType |
| media.AVPlayer | url ?: string |
| media.AVPlayer | surfaceId ?: string |
| media.AVPlayer | stop(callback: AsyncCallback<void>): void |
| media.AVPlayer | stop(): Promise<void> |
| media.AVPlayer | setVolume(volume: number): void |
| media.AVPlayer | setSpeed(speed: PlaybackSpeed): void |
| media.AVPlayer | setBitrate(bitrate: number): void |
| media.AVPlayer | seek(timeMs: number, mode?:SeekMode): void |
| media.AVPlayer | reset(callback: AsyncCallback<void>): void |
| media.AVPlayer | reset(): Promise<void> |
| media.AVPlayer | release(callback: AsyncCallback<void>): void |
| media.AVPlayer | release(): Promise<void> |
| media.AVPlayer | readonly width: number |
| media.AVPlayer | readonly state: AVPlayerState |
| media.AVPlayer | readonly height: number |
| media.AVPlayer | readonly duration: number |
| media.AVPlayer | readonly currentTime: number |
| media.AVPlayer | prepare(callback: AsyncCallback<void>): void |
| media.AVPlayer | prepare(): Promise<void> |
| media.AVPlayer | play(callback: AsyncCallback<void>): void |
| media.AVPlayer | play(): Promise<void> |
| media.AVPlayer | pause(callback: AsyncCallback<void>): void |
| media.AVPlayer | pause(): Promise<void> |
| media.AVPlayer | on(type: ‘volumeChange’, callback: Callback<number>): void |
| media.AVPlayer | on(type: ‘videoSizeChange’, callback: (width: number, height: number) => void): void |
| media.AVPlayer | on(type: ‘timeUpdate’, callback: Callback<number>): void |
| media.AVPlayer | on(type: ‘stateChange’, callback: (state: AVPlayerState, reason: StateChangeReason) => void): void |
| media.AVPlayer | on(type: ‘startRenderFrame’, callback: Callback<void>): void |
| media.AVPlayer | on(type: ‘speedDone’, callback: Callback<number>): void |
| media.AVPlayer | on(type: ‘seekDone’, callback: Callback<number>): void |
| media.AVPlayer | on(type: ‘error’, callback: ErrorCallback): void |
| media.AVPlayer | on(type: ‘endOfStream’, callback: Callback<void>): void |
| media.AVPlayer | on(type: ‘durationUpdate’, callback: Callback<number>): void |
| media.AVPlayer | on(type: ‘bufferingUpdate’, callback: (infoType: BufferingInfoType, value: number) => void): void |
| media.AVPlayer | on(type: ‘bitrateDone’, callback: Callback<number>): void |
| media.AVPlayer | on(type: ‘availableBitrates’, callback: (bitrates: Array<number>) => void): void |
| media.AVPlayer | on(type: ‘audioInterrupt’, callback: (info: audio.InterruptEvent) => void): void |
| media.AVPlayer | off(type: ‘volumeChange’): void |
| media.AVPlayer | off(type: ‘videoSizeChange’): void |
| media.AVPlayer | off(type: ‘timeUpdate’): void |
| media.AVPlayer | off(type: ‘stateChange’): void |
| media.AVPlayer | off(type: ‘startRenderFrame’): void |
| media.AVPlayer | off(type: ‘speedDone’): void |
| media.AVPlayer | off(type: ‘seekDone’): void |
| media.AVPlayer | off(type: ‘error’): void |
| media.AVPlayer | off(type: ‘endOfStream’): void |
| media.AVPlayer | off(type: ‘durationUpdate’): void |
| media.AVPlayer | off(type: ‘bufferingUpdate’): void |
| media.AVPlayer | off(type: ‘bitrateDone’): void |
| media.AVPlayer | off(type: ‘availableBitrates’): void |
| media.AVPlayer | off(type: ‘audioInterrupt’): void |
| media.AVPlayer | loop: boolean |
| media.AVPlayer | getTrackDescription(callback: AsyncCallback<Array<MediaDescription>>): void |
| media.AVPlayer | getTrackDescription() : Promise<Array<MediaDescription>> |
| media.AVPlayer | fdSrc ?: AVFileDescriptor |
| media.AVPlayer | audioInterruptMode ?: audio.InterruptMode |
| unnamed | type AVPlayerState = ‘idle’ |‘initialized’ |‘prepared’ |‘playing’ |‘paused’ |‘completed’ |‘stopped’ |‘released’ |‘error’ |
停止维护接口如下：
| 类名 | 停止维护接口声明 |
|---|---|
| media | createVideoPlayer(callback: AsyncCallback<VideoPlayer>): void |
| media | createVideoPlayer() : Promise<VideoPlayer> |
| media | createAudioPlayer(): AudioPlayer |
| media.AudioPlayer | interface AudioPlayer |
| media.AudioPlayer | play(): void |
| media.AudioPlayer | release(): void |
| media.AudioPlayer | audioInterruptMode ?: audio.InterruptMode |
| media.AudioPlayer | fdSrc: AVFileDescriptor |
| media.AudioPlayer | seek(timeMs: number): void |
| media.AudioPlayer | readonly duration: number |
| media.AudioPlayer | loop: boolean |
| media.AudioPlayer | readonly state: AudioState |
| media.AudioPlayer | getTrackDescription(callback: AsyncCallback<Array<MediaDescription>>): void |
| media.AudioPlayer | getTrackDescription() : Promise<Array<MediaDescription>> |
| media.AudioPlayer | on(type: ‘bufferingUpdate’, callback: (infoType: BufferingInfoType, value: number) => void): void |
| media.AudioPlayer | on(type: ‘play’ |‘pause’ |‘stop’ |‘reset’ |‘dataLoad’ |‘finish’ |‘volumeChange’, callback: () => void): void |
| media.AudioPlayer | on(type: ‘timeUpdate’, callback: Callback<number>): void |
| media.AudioPlayer | on(type: ‘audioInterrupt’, callback: (info: audio.InterruptEvent) => void): void |
| media.AudioPlayer | on(type: ‘error’, callback: ErrorCallback): void |
| media.AudioPlayer | setVolume(vol: number): void |
| media.AudioPlayer | pause(): void |
| media.AudioPlayer | readonly currentTime: number |
| media.AudioPlayer | stop(): void |
| media.AudioPlayer | reset(): void |
| media.AudioPlayer | src: string |
| media.VideoPlayer | interface VideoPlayer |
| media.VideoPlayer | play(callback: AsyncCallback<void>): void |
| media.VideoPlayer | play(): Promise<void> |
| media.VideoPlayer | prepare(callback: AsyncCallback<void>): void |
| media.VideoPlayer | prepare(): Promise<void> |
| media.VideoPlayer | release(callback: AsyncCallback<void>): void |
| media.VideoPlayer | release(): Promise<void> |
| media.VideoPlayer | audioInterruptMode ?: audio.InterruptMode |
| media.VideoPlayer | fdSrc: AVFileDescriptor |
| media.VideoPlayer | seek(timeMs: number, callback: AsyncCallback<number>): void |
| media.VideoPlayer | seek(timeMs: number, mode:SeekMode, callback: AsyncCallback<number>): void |
| media.VideoPlayer | seek(timeMs: number, mode?:SeekMode): Promise<number> |
| media.VideoPlayer | readonly duration: number |
| media.VideoPlayer | loop: boolean |
| media.VideoPlayer | videoScaleType ?: VideoScaleType |
| media.VideoPlayer | readonly state: VideoPlayState |
| media.VideoPlayer | getTrackDescription(callback: AsyncCallback<Array<MediaDescription>>): void |
| media.VideoPlayer | getTrackDescription() : Promise<Array<MediaDescription>> |
| media.VideoPlayer | readonly height: number |
| media.VideoPlayer | on(type: ‘playbackCompleted’, callback: Callback<void>): void |
| media.VideoPlayer | on(type: ‘bufferingUpdate’, callback: (infoType: BufferingInfoType, value: number) => void): void |
| media.VideoPlayer | on(type: ‘startRenderFrame’, callback: Callback<void>): void |
| media.VideoPlayer | on(type: ‘videoSizeChanged’, callback: (width: number, height: number) => void): void |
| media.VideoPlayer | on(type: ‘audioInterrupt’, callback: (info: audio.InterruptEvent) => void): void |
| media.VideoPlayer | on(type: ‘error’, callback: ErrorCallback): void |
| media.VideoPlayer | setDisplaySurface(surfaceId: string, callback: AsyncCallback<void>): void |
| media.VideoPlayer | setDisplaySurface(surfaceId: string): Promise<void> |
| media.VideoPlayer | setVolume(vol: number, callback: AsyncCallback<void>): void |
| media.VideoPlayer | setVolume(vol: number): Promise<void> |
| media.VideoPlayer | url: string |
| media.VideoPlayer | pause(callback: AsyncCallback<void>): void |
| media.VideoPlayer | pause(): Promise<void> |
| media.VideoPlayer | readonly currentTime: number |
| media.VideoPlayer | setSpeed(speed:number, callback: AsyncCallback<number>): void |
| media.VideoPlayer | setSpeed(speed:number): Promise<number> |
| media.VideoPlayer | stop(callback: AsyncCallback<void>): void |
| media.VideoPlayer | stop(): Promise<void> |
| media.VideoPlayer | readonly width: number |
| media.VideoPlayer | reset(callback: AsyncCallback<void>): void |
| media.VideoPlayer | reset(): Promise<void> |
| unnamed | type AudioState = ‘idle’ |‘playing’ |‘paused’ |‘stopped’ |‘error’ |
| unnamed | type VideoPlayState = ‘idle’ |‘prepared’ |‘playing’ |‘paused’ |‘stopped’ |‘error’ |
适配指导
请参考各接口的API参考
cl.media.2 录制功能接口变更
新增音视频录制接口AVRecorder9+， 升级了状态机和错误码，推荐用户使用。旧版音频录制接口AudioRecorder6+和视频录制接口VideoRecorder9+停止维护。
新旧录制接口共用的AudioSourceType和VideoSourceType接口，变更为非系统接口。
变更影响
原有的接口AudioRecorder6+和VideoRecorder9+暂时可继续使用，但是停止维护，建议使用新接口进行开发AVRecorder9+。
关键的接口/组件变更
新增接口如下：
| 类名 | 新增接口声明 |
|---|---|
| media | createAVRecorder(callback: AsyncCallback<AVRecorder>): void |
| media | createAVRecorder() : Promise<AVRecorder> |
| media.AVRecorder | interface AVRecorder |
| media.AVRecorder | prepare(config: AVRecorderConfig, callback: AsyncCallback<void>): void |
| media.AVRecorder | prepare(config: AVRecorderConfig): Promise<void> |
| media.AVRecorder | release(callback: AsyncCallback<void>): void |
| media.AVRecorder | release(): Promise<void> |
| media.AVRecorder | readonly state: AVRecorderState |
| media.AVRecorder | on(type: ‘stateChange’, callback: (state: AVRecorderState, reason: StateChangeReason) => void): void |
| media.AVRecorder | on(type: ‘error’, callback: ErrorCallback): void |
| media.AVRecorder | resume(callback: AsyncCallback<void>): void |
| media.AVRecorder | resume(): Promise<void> |
| media.AVRecorder | start(callback: AsyncCallback<void>): void |
| media.AVRecorder | start(): Promise<void> |
| media.AVRecorder | off(type: ‘stateChange’): void |
| media.AVRecorder | off(type: ‘error’): void |
| media.AVRecorder | pause(callback: AsyncCallback<void>): void |
| media.AVRecorder | pause(): Promise<void> |
| media.AVRecorder | stop(callback: AsyncCallback<void>): void |
| media.AVRecorder | stop(): Promise<void> |
| media.AVRecorder | reset(callback: AsyncCallback<void>): void |
| media.AVRecorder | reset(): Promise<void> |
| media.AVRecorder | getInputSurface(callback: AsyncCallback<string>): void |
| media.AVRecorder | getInputSurface(): Promise<string> |
| media.AVRecorderConfig | videoSourceType?: VideoSourceType |
| media.AVRecorderConfig | audioSourceType?: AudioSourceType |
| media.AVRecorderConfig | profile: AVRecorderProfile |
| media.AVRecorderConfig | rotation?: number |
| media.AVRecorderConfig | url: string |
| media.AVRecorderConfig | location?: Location |
| media.AVRecorderConfig | interface AVRecorderConfig |
| media.AVRecorderProfile | videoBitrate?: number |
| media.AVRecorderProfile | videoCodec?: CodecMimeType |
| media.AVRecorderProfile | audioCodec?: CodecMimeType |
| media.AVRecorderProfile | videoFrameRate?: number |
| media.AVRecorderProfile | videoFrameHeight?: number |
| media.AVRecorderProfile | audioSampleRate?: number |
| media.AVRecorderProfile | audioBitrate?: number |
| media.AVRecorderProfile | videoFrameWidth?: number |
| media.AVRecorderProfile | audioChannels?: number |
| media.AVRecorderProfile | fileFormat: ContainerFormatType |
| media.AVRecorderProfile | interface AVRecorderProfile |
| unnamed | type AVRecorderState = ‘idle’ |‘prepared’ |‘started’ |‘paused’ |‘stopped’ |‘released’ |‘error’ |
停止维护接口如下：
| 类名 | 停止维护接口声明 |
|---|---|
| media | createVideoRecorder(callback: AsyncCallback<VideoRecorder>): void |
| media | createVideoRecorder(): Promise<VideoRecorder> |
| media | createAudioRecorder(): AudioRecorder |
| media.AudioRecorder | interface AudioRecorder |
| media.AudioRecorder | prepare(config: AudioRecorderConfig): void |
| media.AudioRecorder | release(): void |
| media.AudioRecorder | on(type: ‘prepare’ |‘start’ |‘pause’ |‘resume’ |‘stop’ |‘release’ |‘reset’, callback: () => void): void |
| media.AudioRecorder | on(type: ‘error’, callback: ErrorCallback): void |
| media.AudioRecorder | resume(): void |
| media.AudioRecorder | start(): void |
| media.AudioRecorder | pause(): void |
| media.AudioRecorder | stop(): void |
| media.AudioRecorder | reset(): void |
| media.AudioRecorderConfig | audioSampleRate?: number |
| media.AudioRecorderConfig | location?: Location |
| media.AudioRecorderConfig | fileFormat?: ContainerFormatType |
| media.AudioRecorderConfig | interface AudioRecorderConfig |
| media.AudioRecorderConfig | audioEncoder?: AudioEncoder |
| media.AudioRecorderConfig | audioEncodeBitRate?: number |
| media.AudioRecorderConfig | numberOfChannels?: number |
| media.AudioRecorderConfig | format?: AudioOutputFormat |
| media.AudioRecorderConfig | uri: string |
| media.AudioRecorderConfig | audioEncoderMime?: CodecMimeType |
| media.VideoRecorder | interface VideoRecorder |
| media.VideoRecorder | prepare(config: VideoRecorderConfig, callback: AsyncCallback<void>): void |
| media.VideoRecorder | prepare(config: VideoRecorderConfig): Promise<void> |
| media.VideoRecorder | release(callback: AsyncCallback<void>): void |
| media.VideoRecorder | release(): Promise<void> |
| media.VideoRecorder | readonly state: VideoRecordState |
| media.VideoRecorder | on(type: ‘error’, callback: ErrorCallback): void |
| media.VideoRecorder | resume(callback: AsyncCallback<void>): void |
| media.VideoRecorder | resume(): Promise<void> |
| media.VideoRecorder | start(callback: AsyncCallback<void>): void |
| media.VideoRecorder | start(): Promise<void> |
| media.VideoRecorder | pause(callback: AsyncCallback<void>): void |
| media.VideoRecorder | pause(): Promise<void> |
| media.VideoRecorder | stop(callback: AsyncCallback<void>): void |
| media.VideoRecorder | stop(): Promise<void> |
| media.VideoRecorder | reset(callback: AsyncCallback<void>): void |
| media.VideoRecorder | reset(): Promise<void> |
| media.VideoRecorder | getInputSurface(callback: AsyncCallback<string>): void |
| media.VideoRecorder | getInputSurface(): Promise<string> |
| media.VideoRecorderConfig | videoSourceType: VideoSourceType |
| media.VideoRecorderConfig | audioSourceType?: AudioSourceType |
| media.VideoRecorderConfig | profile: VideoRecorderProfile |
| media.VideoRecorderConfig | rotation?: number |
| media.VideoRecorderConfig | url: string |
| media.VideoRecorderConfig | location?: Location |
| media.VideoRecorderConfig | interface VideoRecorderConfig |
| media.VideoRecorderProfile | readonly videoBitrate: number |
| media.VideoRecorderProfile | readonly videoCodec: CodecMimeType |
| media.VideoRecorderProfile | readonly audioCodec: CodecMimeType |
| media.VideoRecorderProfile | readonly videoFrameRate: number |
| media.VideoRecorderProfile | readonly videoFrameHeight: number |
| media.VideoRecorderProfile | readonly audioSampleRate: number |
| media.VideoRecorderProfile | readonly audioBitrate: number |
| media.VideoRecorderProfile | readonly videoFrameWidth: number |
| media.VideoRecorderProfile | readonly audioChannels: number |
| media.VideoRecorderProfile | readonly fileFormat: ContainerFormatType |
| media.VideoRecorderProfile | interface VideoRecorderProfile |
| unnamed | type VideoRecordState = ‘idle’ |‘prepared’ |‘playing’ |‘paused’ |‘stopped’ |‘error’ |
变更接口如下：
| 类名 | 接口声明 | 变更前能力 | 变更后能力 | 变更前是否为系统接口 | 变更后是否为系统接口 |
|---|---|---|---|---|---|
| media.AudioSourceType | enum AudioSourceType { /** * default audio source type. * @since 9 * @syscap SystemCapability.Multimedia.Media.AVRecorder */ AUDIO_SOURCE_TYPE_DEFAULT = 0, /** * source type mic. * @since 9 * @syscap SystemCapability.Multimedia.Media.AVRecorder */ AUDIO_SOURCE_TYPE_MIC = 1, } | SystemCapability.Multimedia.Media.VideoRecorder | SystemCapability.Multimedia.Media.AVRecorder | 是 | 否 |
| media.VideoSourceType | enum VideoSourceType { /** * surface raw data. * @since 9 * @syscap SystemCapability.Multimedia.Media.AVRecorder */ VIDEO_SOURCE_TYPE_SURFACE_YUV = 0, /** * surface ES data. * @since 9 * @syscap SystemCapability.Multimedia.Media.AVRecorder */ VIDEO_SOURCE_TYPE_SURFACE_ES = 1, } | SystemCapability.Multimedia.Media.VideoRecorder | SystemCapability.Multimedia.Media.AVRecorder | 是 | 否 |
适配指导
请参考各接口的API参考
cl.media.3 错误码变更
新增标准的错误枚举类型AVErrorCode99+替代原有错误枚举类型MediaErrorCode8+。
变更影响
以往接口返回错误码枚举类型为MediaErrorCode8+不变。新增接口错误码类型均采用AVErrorCode99+。
关键的接口/组件变更
新增接口如下：
| 类名 | 新增错误码声明 |
|---|---|
| media.AVErrorCode | enum AVErrorCode { /** * operation success. * @since 9 * @syscap SystemCapability.Multimedia.Media.Core */ AVERR_OK = 0, /** * permission denied. * @since 9 * @syscap SystemCapability.Multimedia.Media.Core */ AVERR_NO_PERMISSION = 201, /** * invalid parameter. * @since 9 * @syscap SystemCapability.Multimedia.Media.Core */ AVERR_INVALID_PARAMETER = 401, /** * the api is not supported in the current version * @since 9 * @syscap SystemCapability.Multimedia.Media.Core */ AVERR_UNSUPPORT_CAPABILITY = 801, /** * the system memory is insufficient or the number of services reaches the upper limit * @since 9 * @syscap SystemCapability.Multimedia.Media.Core */ AVERR_NO_MEMORY = 5400101, /** * current status does not allow or do not have permission to perform this operation * @since 9 * @syscap SystemCapability.Multimedia.Media.Core */ AVERR_OPERATE_NOT_PERMIT = 5400102, /** * data flow exception information * @since 9 * @syscap SystemCapability.Multimedia.Media.Core */ AVERR_IO = 5400103, /** * system or network response timeout. * @since 9 * @syscap SystemCapability.Multimedia.Media.Core */ AVERR_TIMEOUT = 5400104, /** * service process died. * @since 9 * @syscap SystemCapability.Multimedia.Media.Core */ AVERR_SERVICE_DIED = 5400105, /** * unsupported media format * @since 9 * @syscap SystemCapability.Multimedia.Media.Core */ AVERR_UNSUPPORT_FORMAT = 5400106, } |
停止维护接口如下：
| 类名 | 停止维护错误码声明 |
|---|---|
| media.MediaErrorCode | enum MediaErrorCode { /** * operation success. * @since 8 * @syscap SystemCapability.Multimedia.Media.Core */ MSERR_OK = 0, /** * malloc or new memory failed. maybe system have no memory. * @since 8 * @syscap SystemCapability.Multimedia.Media.Core */ MSERR_NO_MEMORY = 1, /** * no permission for the operation. * @since 8 * @syscap SystemCapability.Multimedia.Media.Core */ MSERR_OPERATION_NOT_PERMIT = 2, /** * invalid argument. * @since 8 * @syscap SystemCapability.Multimedia.Media.Core */ MSERR_INVALID_VAL = 3, /** * an I/O error occurred. * @since 8 * @syscap SystemCapability.Multimedia.Media.Core */ MSERR_IO = 4, /** * operation time out. * @since 8 * @syscap SystemCapability.Multimedia.Media.Core */ MSERR_TIMEOUT = 5, /** * unknown error. * @since 8 * @syscap SystemCapability.Multimedia.Media.Core */ MSERR_UNKNOWN = 6, /** * media service died. * @since 8 * @syscap SystemCapability.Multimedia.Media.Core */ MSERR_SERVICE_DIED = 7, /** * operation is not permit in current state. * @since 8 * @syscap SystemCapability.Multimedia.Media.Core */ MSERR_INVALID_STATE = 8, /** * operation is not supported in current version. * @since 8 * @syscap SystemCapability.Multimedia.Media.Core */ MSERR_UNSUPPORTED = 9, } |
你可能感兴趣的鸿蒙文章
0
赞
- 所属分类： 后端技术
- 本文标签：
热门推荐
-
2、 - 优质文章
-
3、 gate.io
-
8、 golang
-
9、 openharmony
-
10、 Vue中input框自动聚焦