diff --git a/zh-cn/release-notes/changelogs/OpenHarmony_3.2.8.3/changelogs-multimedia.md b/zh-cn/release-notes/changelogs/OpenHarmony_3.2.8.3/changelogs-multimedia.md index 8aa0a92236e29758a6dcc3a4b582c95a9b1ae9de..9d85704839aa1e97c7f24dda8349d678c08ce1cc 100644 --- a/zh-cn/release-notes/changelogs/OpenHarmony_3.2.8.3/changelogs-multimedia.md +++ b/zh-cn/release-notes/changelogs/OpenHarmony_3.2.8.3/changelogs-multimedia.md @@ -163,3 +163,100 @@ interface AudioRenderer { on(type: 'audioInterrupt', callback: Callback): void; } ``` + + +## cl.multimedia.media.001 VideoRecorder相关接口变更为systemapi + +录制在MR版本会提供正式的AVRecorder(音视频合一)的接口给外部用户使用。 +VideoRecorder相关的api9接口变更为systemapi,当前只提供给系统用户使用,未来等内部用户都切换为AVRecorder之后,废弃VideoRecorder相关接口。 + +**变更影响** + +如果VideoRecorder的调用者非系统用户,会调用失败。 +涉及接口以及枚举如下: +function createVideoRecorder(callback: AsyncCallback): void; +function createVideoRecorder(): Promise; +type VideoRecordState = 'idle' | 'prepared' | 'playing' | 'paused' | 'stopped' | 'error'; +interface VideoRecorder{ + prepare(config: VideoRecorderConfig, callback: AsyncCallback): void; + prepare(config: VideoRecorderConfig): Promise; + getInputSurface(callback: AsyncCallback): void; + getInputSurface(): Promise; + start(callback: AsyncCallback): void; + start(): Promise; + pause(callback: AsyncCallback): void; + pause(): Promise; + resume(callback: AsyncCallback): void; + resume(): Promise; + stop(callback: AsyncCallback): void; + stop(): Promise; + release(callback: AsyncCallback): void; + release(): Promise; + reset(callback: AsyncCallback): void; + reset(): Promise; + on(type: 'error', callback: ErrorCallback): void; + readonly state: VideoRecordState; +} +interface VideoRecorderProfile { + readonly audioBitrate: number; + readonly audioChannels: number; + readonly audioCodec: CodecMimeType; + readonly audioSampleRate: number; + readonly fileFormat: ContainerFormatType; + readonly videoBitrate: number; + readonly videoCodec: CodecMimeType; + readonly videoFrameWidth: number; + readonly videoFrameHeight: number; + readonly videoFrameRate: number; +} +enum AudioSourceType { + AUDIO_SOURCE_TYPE_DEFAULT = 0, + AUDIO_SOURCE_TYPE_MIC = 1, +} +enum VideoSourceType { + VIDEO_SOURCE_TYPE_SURFACE_YUV = 0, + VIDEO_SOURCE_TYPE_SURFACE_ES = 1, +} +enum VideoRecorderConfig { + audioSourceType?: AudioSourceType; + videoSourceType: VideoSourceType; + profile: VideoRecorderProfile; + url: string; + rotation?: number; + location?: Location; +} + +## cl.multimedia.media.002 VideoPlayer中不对外提供多码率选择接口 + +VideoPlayer在API9中不对外提供多码率选择相关接口,相关接口会在MR版本中由AvPlayer提供。 + +**变更影响** + +VideoPlayer多码率场景无法进行码率选择,相关功能由AVPlayer提供 + +**关键的接口/组件变更** + +删除如下接口 +interface VideoPlayer { + selectBitrate(bitrate: number): Promise; + selectBitrate(bitrate: number, callback: AsyncCallback): void; + on(type: 'availableBitratesCollect', callback: (bitrates: Array) => void): void; +} + +## cl.multimedia.media.003 VideoRecorder错误信息变更 + +VideoRecorder原有错误码与整体错误码规则不一致,变更错误码适配规则。 + +**变更影响** + +VideoRecorder返回的错误码发生变更。 + +**关键的接口/组件变更** + +VideoRecorder接口未发生变更,返回的错误码发生变更。 + +**适配指导** + +异常处理具体参考接口文档。 +https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-media.md +https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/errorcodes/errorcode-media.md