相机变更说明
cl.camera.1 getSupportedOutputCapability接口变更
访问级别
公开接口
变更原因
getSupportedOutputCapability用来查询相机设备支持的输出能力，增加入参mode: SceneMode，接口改为查询相机设备在模式下支持的输出能力。
变更影响
getSupportedOutputCapability(camera: CameraDevice): CameraOutputCapability会在API11版本废弃，保留五个版本。 API11版本新增getSupportedOutputCapability(camera: CameraDevice, mode: SceneMode): CameraOutputCapability。
关键的接口/组件变更
-
涉及接口
getSupportedOutputCapability(camera: CameraDevice): CameraOutputCapability
-
变更前：
入参只有相机设备camera: CameraDevice。
-
变更后：
增加入参相机模式mode: SceneMode。
适配指导
先通过API11新增接口getSupportedSceneModes(camera: CameraDevice): Array<SceneMode>， 来获取相机设备对象支持的模式，再通过新增getSupportedOutputCapability(camera: CameraDevice, mode: SceneMode): CameraOutputCapability接口，查询相机设备在模式下支持的输出能力。
API Level
11
变更发生版本
从OpenHarmony SDK 4.1.6.3开始。
cl.camera.2 createPhotoOutput接口变更
访问级别
公开接口
变更原因
createPhotoOutput用来创建拍照输出对象，删除入参surfaceId: string，接口改为只通过拍照配置信息创建拍照输出对象。
变更影响
createPhotoOutput(profile: Profile, surfaceId: string): PhotoOutput会在API11版本废弃，保留五个版本。 API11版本新增createPhotoOutput(profile: Profile): PhotoOutput。
关键的接口/组件变更
-
涉及接口
createPhotoOutput(profile: Profile, surfaceId: string): PhotoOutput
-
变更前：
入参包含支持的拍照配置信息profile以及从ImageReceiver获取的surfaceId。
-
变更后：
入参只有支持的拍照配置信息profile。
适配指导
先通过API11新增接口createPhotoOutput(profile: Profile): PhotoOutput， 来创建拍照输出对象。
API Level
11
变更发生版本
从OpenHarmony SDK 4.1.6.3开始。
cl.camera.3 createCaptureSession接口变更
访问级别
公开接口
变更原因
createCaptureSession用来创建CaptureSession实例，API11后，Session通过模式进行区分，分为PhotoSession和VideoSession，通过API11新增接口createSession<T extends Session>(mode: SceneMode): T进行创建。
变更影响
createCaptureSession(): CaptureSession会在API11版本废弃，保留五个版本。 API11版本新增createSession<T extends Session>(mode: SceneMode): T。
关键的接口/组件变更
-
涉及接口
createPhotoOutput(profile: Profile, surfaceId: string): PhotoOutput
-
变更前：
通过createCaptureSession(): CaptureSession创建CaptureSession实例。
-
变更后：
通过createSession<T extends Session>(mode: SceneMode): T创建对应模式的Session。
适配指导
通过API11新增接口createSession<T extends Session>(mode: SceneMode): T创建对应模式的Session。
API Level
11
变更发生版本
从OpenHarmony SDK 4.1.6.3开始。
cl.camera.4 CaptureSession接口变更
访问级别
公开接口
变更原因
CaptureSession用来保存一次相机运行所需要的所有资源CameraInput、CameraOutput，并向相机设备申请完成相机功能（录像，拍照）的会话类。
变更影响
CaptureSession以及包含的接口会在API11版本废弃，保留五个版本。 API11版本新增PhotoSession和VideoSession区分录像会话和拍照会话。
关键的接口/组件变更
-
涉及接口
CaptureSession
-
变更前：
通过createCaptureSession(): CaptureSession创建CaptureSession实例。
-
变更后：
通过createSession<T extends Session>(mode: SceneMode): T创建录像会话和拍照会话对应模式的Session。
适配指导
通过API11新增接口PhotoSession对应拍照模式会话，VideoSession对应录像模式会话。
API Level
11
变更发生版本
从OpenHarmony SDK 4.1.6.3开始。
cl.camera.5 PreviewOutput类start与stop接口变更
访问级别
公开接口
变更原因
PreviewOutput作为相机的预览输出，和会话保持一致，因此会话中的开始与停止操作，可以包含预览输出的开始与停止操作，因此PreviewOutput中的start与stop操作，在API11版本合并至Session的start与stop操作中。
变更影响
PreviewOutput接口包含的start与stop接口会在API11版本废弃，保留五个版本，合并至Session的start与stop操作中。
关键的接口/组件变更
-
涉及接口
PreviewOutput类start与stop
-
变更前：
interface PreviewOutput extends CameraOutput start(callback: AsyncCallback<void>): void start(): Promise<void> stop(callback: AsyncCallback<void>): void stop(): Promise<void>
-
变更后：
合并至PhotoSession或VideoSession的start和stop接口。
适配指导
无需适配，通过API11新增的PhotoSession或VideoSession的start和stop接口，或是CaptureSession的start和stop接口，即可执行PreviewOutput类的start和stop接口。
cl.camera.6 captureStart注册监听与解除注册监听接口变更
API Level
11
变更发生版本
从OpenHarmony SDK 4.1.6.3开始。
访问级别
公开接口
变更原因
captureStart注册监听与解除注册监听接口用来监听拍照开始，通过注册回调函数获取Capture ID，在API11版本中，captureStart事件会返回更多的信息，相关回调无法获取更多信息。
变更影响
captureStart注册监听与解除注册监听接口以及包含的接口会在API11版本废弃，保留五个版本。 API11版本新增captureStartInfo注册监听与解除注册监听接口。回调数据为CaptureStartInfo结构体，可扩展性获取更多信息
关键的接口/组件变更
-
涉及接口
on(type: 'captureStart', callback: AsyncCallback<number>): void off(type: 'captureStart', callback?: AsyncCallback<number>): void
-
变更前：
通过captureStart注册监听与解除注册监听接口用来监听拍照开始，通过注册回调函数获取Capture ID。
-
变更后：
新增CaptureStartInfo结构体，可扩展性获取更多信息 新增on(type: 'captureStartWithInfo', callback: AsyncCallback<CaptureStartInfo>): void 新增off(type: 'captureStartWithInfo', callback?: AsyncCallback<CaptureStartInfo>): void
适配指导
通过API11新增captureStartInfo注册监听与解除注册监听接口获取CaptureStartInfo。
API Level
11
变更发生版本
从OpenHarmony SDK 4.1.6.3开始。