## 概述

PhonePC/2in1TabletTVWearable

声明预览输出概念。

**引用文件：** <ohcamera/preview\_output.h>

**库：** libohcamera.so

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

**起始版本：** 11

**相关模块：** [OH\_Camera](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-oh-camera)

## 汇总

PhonePC/2in1TabletTVWearable

### 结构体

PhonePC/2in1TabletTVWearable

展开

| 名称 | typedef关键字 | 描述 |
| --- | --- | --- |
| [PreviewOutput\_Callbacks](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-oh-camera-previewoutput-callbacks) | PreviewOutput\_Callbacks | 用于预览输出的回调。 |
| [Camera\_PreviewOutput](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-oh-camera-camera-previewoutput) | Camera\_PreviewOutput | 预览输出对象。  可以使用[OH\_CameraManager\_CreatePreviewOutput](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-camera-manager-h#oh_cameramanager_createpreviewoutput)方法创建指针。 |

### 函数

PhonePC/2in1TabletTVWearable

展开

| 名称 | typedef关键字 | 描述 |
| --- | --- | --- |
| [typedef void (\*OH\_PreviewOutput\_OnFrameStart)(Camera\_PreviewOutput\* previewOutput)](/consumer/cn/doc/harmonyos-references/capi-preview-output-h#oh_previewoutput_onframestart) | OH\_PreviewOutput\_OnFrameStart | 在[PreviewOutput\_Callbacks](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-oh-camera-previewoutput-callbacks)中被调用的预览输出帧开始回调。 |
| [typedef void (\*OH\_PreviewOutput\_OnFrameEnd)(Camera\_PreviewOutput\* previewOutput, int32\_t frameCount)](/consumer/cn/doc/harmonyos-references/capi-preview-output-h#oh_previewoutput_onframeend) | OH\_PreviewOutput\_OnFrameEnd | 在[PreviewOutput\_Callbacks](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-oh-camera-previewoutput-callbacks)中被调用的预览输出帧结束回调。 |
| [typedef void (\*OH\_PreviewOutput\_OnError)(Camera\_PreviewOutput\* previewOutput, Camera\_ErrorCode errorCode)](/consumer/cn/doc/harmonyos-references/capi-preview-output-h#oh_previewoutput_onerror) | OH\_PreviewOutput\_OnError | 在[PreviewOutput\_Callbacks](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-oh-camera-previewoutput-callbacks)中被调用的预览输出帧错误回调。 |
| [Camera\_ErrorCode OH\_PreviewOutput\_RegisterCallback(Camera\_PreviewOutput\* previewOutput, PreviewOutput\_Callbacks\* callback)](/consumer/cn/doc/harmonyos-references/capi-preview-output-h#oh_previewoutput_registercallback) | - | 注册预览输出更改事件回调。 |
| [Camera\_ErrorCode OH\_PreviewOutput\_UnregisterCallback(Camera\_PreviewOutput\* previewOutput, PreviewOutput\_Callbacks\* callback)](/consumer/cn/doc/harmonyos-references/capi-preview-output-h#oh_previewoutput_unregistercallback) | - | 注销预览输出更改事件回调。 |
| [Camera\_ErrorCode OH\_PreviewOutput\_Start(Camera\_PreviewOutput\* previewOutput)](/consumer/cn/doc/harmonyos-references/capi-preview-output-h#oh_previewoutput_start) | - | 开始预览输出。 |
| [Camera\_ErrorCode OH\_PreviewOutput\_Stop(Camera\_PreviewOutput\* previewOutput)](/consumer/cn/doc/harmonyos-references/capi-preview-output-h#oh_previewoutput_stop) | - | 停止预览输出。 |
| [Camera\_ErrorCode OH\_PreviewOutput\_Release(Camera\_PreviewOutput\* previewOutput)](/consumer/cn/doc/harmonyos-references/capi-preview-output-h#oh_previewoutput_release) | - | 释放预览输出实例。 |
| [Camera\_ErrorCode OH\_PreviewOutput\_GetActiveProfile(Camera\_PreviewOutput\* previewOutput, Camera\_Profile\*\* profile)](/consumer/cn/doc/harmonyos-references/capi-preview-output-h#oh_previewoutput_getactiveprofile) | - | 获取当前预览输出配置文件。 |
| [Camera\_ErrorCode OH\_PreviewOutput\_DeleteProfile(Camera\_Profile\* profile)](/consumer/cn/doc/harmonyos-references/capi-preview-output-h#oh_previewoutput_deleteprofile) | - | 删除预览配置文件实例。 |
| [Camera\_ErrorCode OH\_PreviewOutput\_GetPreviewRotation(Camera\_PreviewOutput\* previewOutput, int displayRotation, Camera\_ImageRotation\* imageRotation)](/consumer/cn/doc/harmonyos-references/capi-preview-output-h#oh_previewoutput_getpreviewrotation) | - | 获取相机预览旋转角度。 |
| [Camera\_ErrorCode OH\_PreviewOutput\_GetPreviewRotationWithoutDisplayRotation(Camera\_PreviewOutput\* previewOutput, Camera\_ImageRotation\* imageRotation)](/consumer/cn/doc/harmonyos-references/capi-preview-output-h#oh_previewoutput_getpreviewrotationwithoutdisplayrotation) | - | 获取相机预览旋转角度。 |
| [Camera\_ErrorCode OH\_PreviewOutput\_SetPreviewRotation(Camera\_PreviewOutput\* previewOutput, Camera\_ImageRotation previewRotation, bool isDisplayLocked)](/consumer/cn/doc/harmonyos-references/capi-preview-output-h#oh_previewoutput_setpreviewrotation) | - | 设置相机预览旋转角度。 |
| [Camera\_ErrorCode OH\_PreviewOutput\_GetSupportedFrameRates(Camera\_PreviewOutput\* previewOutput, Camera\_FrameRateRange\*\* frameRateRange, uint32\_t\* size)](/consumer/cn/doc/harmonyos-references/capi-preview-output-h#oh_previewoutput_getsupportedframerates) | - | 获取支持的预览输出帧率列表。 |
| [Camera\_ErrorCode OH\_PreviewOutput\_DeleteFrameRates(Camera\_PreviewOutput\* previewOutput, Camera\_FrameRateRange\* frameRateRange)](/consumer/cn/doc/harmonyos-references/capi-preview-output-h#oh_previewoutput_deleteframerates) | - | 删除帧率列表。 |
| [Camera\_ErrorCode OH\_PreviewOutput\_SetFrameRate(Camera\_PreviewOutput\* previewOutput, int32\_t minFps, int32\_t maxFps)](/consumer/cn/doc/harmonyos-references/capi-preview-output-h#oh_previewoutput_setframerate) | - | 设置预览输出帧率。 |
| [Camera\_ErrorCode OH\_PreviewOutput\_GetActiveFrameRate(Camera\_PreviewOutput\* previewOutput, Camera\_FrameRateRange\* frameRateRange)](/consumer/cn/doc/harmonyos-references/capi-preview-output-h#oh_previewoutput_getactiveframerate) | - | 获取当前预览输出帧率。 |
| [Camera\_ErrorCode OH\_PreviewOutput\_IsBandwidthCompressionSupported(Camera\_PreviewOutput\* previewOutput, bool\* isSupported)](/consumer/cn/doc/harmonyos-references/capi-preview-output-h#oh_previewoutput_isbandwidthcompressionsupported) | - | 检查是否支持预览带宽压缩（指通过编码减少数据量，降低其在传输链路中的带宽占用）。 |
| [Camera\_ErrorCode OH\_PreviewOutput\_EnableBandwidthCompression(Camera\_PreviewOutput\* previewOutput, bool enabled)](/consumer/cn/doc/harmonyos-references/capi-preview-output-h#oh_previewoutput_enablebandwidthcompression) | - | 使能预览带宽压缩。  该接口只能在使用[OH\_CaptureSession\_CommitConfig()](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-capture-session-h#oh_capturesession_commitconfig)接口之前调用，否则会影响预览流出流格式。 |
| [Camera\_ErrorCode OH\_PreviewOutput\_AddDeferredSurface(const Camera\_PreviewOutput\* previewOutput, const char\* surfaceId)](/consumer/cn/doc/harmonyos-references/capi-preview-output-h#oh_previewoutput_adddeferredsurface) | - | 配置延迟预览的Surface。 |

## 函数说明

PhonePC/2in1TabletTVWearable

### OH\_PreviewOutput\_OnFrameStart()

PhonePC/2in1TabletTVWearable



```
1. typedef void (*OH_PreviewOutput_OnFrameStart)(Camera_PreviewOutput* previewOutput)
```

**描述**

在[PreviewOutput\_Callbacks](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-oh-camera-previewoutput-callbacks)中被调用的预览输出帧开始回调。

**起始版本：** 11

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [Camera\_PreviewOutput](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-oh-camera-camera-previewoutput)\* previewOutput | 传递回调的预览输出实例。 |

### OH\_PreviewOutput\_OnFrameEnd()

PhonePC/2in1TabletTVWearable



```
1. typedef void (*OH_PreviewOutput_OnFrameEnd)(Camera_PreviewOutput* previewOutput, int32_t frameCount)
```

**描述**

在[PreviewOutput\_Callbacks](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-oh-camera-previewoutput-callbacks)中被调用的预览输出帧结束回调。

**起始版本：** 11

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [Camera\_PreviewOutput](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-oh-camera-camera-previewoutput)\* previewOutput | 传递回调的预览输出实例。 |
| int32\_t frameCount | 回调传递的帧计数。 |

### OH\_PreviewOutput\_OnError()

PhonePC/2in1TabletTVWearable



```
1. typedef void (*OH_PreviewOutput_OnError)(Camera_PreviewOutput* previewOutput, Camera_ErrorCode errorCode)
```

**描述**

在[PreviewOutput\_Callbacks](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-oh-camera-previewoutput-callbacks)中被调用的预览输出帧错误回调。

**起始版本：** 11

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [Camera\_PreviewOutput](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-oh-camera-camera-previewoutput)\* previewOutput | 传递回调的预览输出实例。 |
| [Camera\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-camera-h#camera_errorcode) errorCode | 预览输出的错误码。 |

**参考：**

[CAMERA\_SERVICE\_FATAL\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-camera-h#camera_errorcode)

### OH\_PreviewOutput\_RegisterCallback()

PhonePC/2in1TabletTVWearable



```
1. Camera_ErrorCode OH_PreviewOutput_RegisterCallback(Camera_PreviewOutput* previewOutput, PreviewOutput_Callbacks* callback)
```

**描述**

注册预览输出更改事件回调。

**起始版本：** 11

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [Camera\_PreviewOutput](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-oh-camera-camera-previewoutput)\* previewOutput | 预览输出实例。 |
| [PreviewOutput\_Callbacks](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-oh-camera-previewoutput-callbacks)\* callback | 要注册的预览输出更改事件回调。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [Camera\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-camera-h#camera_errorcode) | CAMERA\_OK：方法调用成功。  CAMERA\_INVALID\_ARGUMENT：参数丢失或参数类型不正确。 |

### OH\_PreviewOutput\_UnregisterCallback()

PhonePC/2in1TabletTVWearable



```
1. Camera_ErrorCode OH_PreviewOutput_UnregisterCallback(Camera_PreviewOutput* previewOutput, PreviewOutput_Callbacks* callback)
```

**描述**

注销预览输出更改事件回调。

**起始版本：** 11

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [Camera\_PreviewOutput](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-oh-camera-camera-previewoutput)\* previewOutput | 预览输出实例。 |
| [PreviewOutput\_Callbacks](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-oh-camera-previewoutput-callbacks)\* callback | 要注销的预览输出更改事件回调。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [Camera\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-camera-h#camera_errorcode) | CAMERA\_OK：方法调用成功。  CAMERA\_INVALID\_ARGUMENT：参数丢失或参数类型不正确。 |

### OH\_PreviewOutput\_Start()

PhonePC/2in1TabletTVWearable



```
1. Camera_ErrorCode OH_PreviewOutput_Start(Camera_PreviewOutput* previewOutput)
```

**描述**

开始预览输出。

**起始版本：** 11

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [Camera\_PreviewOutput](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-oh-camera-camera-previewoutput)\* previewOutput | 要启动的预览输出实例。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [Camera\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-camera-h#camera_errorcode) | CAMERA\_OK：方法调用成功。  CAMERA\_INVALID\_ARGUMENT：参数丢失或参数类型不正确。  CAMERA\_SESSION\_NOT\_CONFIG：捕获会话未配置。  CAMERA\_SERVICE\_FATAL\_ERROR：相机服务异常。 |

### OH\_PreviewOutput\_Stop()

PhonePC/2in1TabletTVWearable



```
1. Camera_ErrorCode OH_PreviewOutput_Stop(Camera_PreviewOutput* previewOutput)
```

**描述**

停止预览输出。

**起始版本：** 11

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [Camera\_PreviewOutput](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-oh-camera-camera-previewoutput)\* previewOutput | 要停止的预览输出实例。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [Camera\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-camera-h#camera_errorcode) | CAMERA\_OK：方法调用成功。  CAMERA\_INVALID\_ARGUMENT：参数丢失或参数类型不正确。  CAMERA\_SERVICE\_FATAL\_ERROR：相机服务异常。 |

### OH\_PreviewOutput\_Release()

PhonePC/2in1TabletTVWearable



```
1. Camera_ErrorCode OH_PreviewOutput_Release(Camera_PreviewOutput* previewOutput)
```

**描述**

释放预览输出实例。

**起始版本：** 11

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [Camera\_PreviewOutput](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-oh-camera-camera-previewoutput)\* previewOutput | 要释放的预览输出实例。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [Camera\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-camera-h#camera_errorcode) | CAMERA\_OK：方法调用成功。  CAMERA\_INVALID\_ARGUMENT：参数丢失或参数类型不正确。  CAMERA\_SERVICE\_FATAL\_ERROR：相机服务异常。 |

### OH\_PreviewOutput\_GetActiveProfile()

PhonePC/2in1TabletTVWearable



```
1. Camera_ErrorCode OH_PreviewOutput_GetActiveProfile(Camera_PreviewOutput* previewOutput, Camera_Profile** profile)
```

**描述**

获取当前预览输出配置文件。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [Camera\_PreviewOutput](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-oh-camera-camera-previewoutput)\* previewOutput | 提供当前预览输出配置文件的预览输出实例。 |
| [Camera\_Profile](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-oh-camera-camera-profile)\*\* profile | 如果方法调用成功，将记录当前的预览输出配置文件。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [Camera\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-camera-h#camera_errorcode) | CAMERA\_OK：方法调用成功。  CAMERA\_INVALID\_ARGUMENT：参数丢失或参数类型不正确。  CAMERA\_SERVICE\_FATAL\_ERROR：相机服务异常。 |

### OH\_PreviewOutput\_DeleteProfile()

PhonePC/2in1TabletTVWearable



```
1. Camera_ErrorCode OH_PreviewOutput_DeleteProfile(Camera_Profile* profile)
```

**描述**

删除预览配置文件实例。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [Camera\_Profile](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-oh-camera-camera-profile)\* profile | 要被删除的预览配置文件实例。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [Camera\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-camera-h#camera_errorcode) | CAMERA\_OK：方法调用成功。  CAMERA\_INVALID\_ARGUMENT：参数丢失或参数类型不正确。 |

### OH\_PreviewOutput\_GetPreviewRotation()

PhonePC/2in1TabletTVWearable



```
1. Camera_ErrorCode OH_PreviewOutput_GetPreviewRotation(Camera_PreviewOutput* previewOutput, int displayRotation, Camera_ImageRotation* imageRotation)
```

**描述**

获取相机预览旋转角度。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [Camera\_PreviewOutput](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-oh-camera-camera-previewoutput)\* previewOutput | 用于获取预览旋转角度的预览输出实例。 |
| int displayRotation | 当前显示的旋转角度。 |
| [Camera\_ImageRotation](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-camera-h#camera_imagerotation)\* imageRotation | 预览旋转角度结果。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [Camera\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-camera-h#camera_errorcode) | CAMERA\_OK：方法调用成功。  CAMERA\_INVALID\_ARGUMENT：参数丢失或参数类型不正确。  CAMERA\_SERVICE\_FATAL\_ERROR：相机服务异常。 |

### OH\_PreviewOutput\_GetPreviewRotationWithoutDisplayRotation()

PhonePC/2in1TabletTVWearable



```
1. Camera_ErrorCode OH_PreviewOutput_GetPreviewRotationWithoutDisplayRotation(Camera_PreviewOutput* previewOutput, Camera_ImageRotation* imageRotation)
```

**描述**

获取相机预览旋转角度。

**起始版本：** 23

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [Camera\_PreviewOutput](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-oh-camera-camera-previewoutput)\* previewOutput | 用于获取预览旋转角度的预览输出实例。 |
| [Camera\_ImageRotation](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-camera-h#camera_imagerotation)\* imageRotation | 预览旋转角度结果。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [Camera\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-camera-h#camera_errorcode) | CAMERA\_OK：方法调用成功。  CAMERA\_INVALID\_ARGUMENT：参数丢失或参数类型不正确。  CAMERA\_SERVICE\_FATAL\_ERROR：相机服务异常。 |

### OH\_PreviewOutput\_SetPreviewRotation()

PhonePC/2in1TabletTVWearable



```
1. Camera_ErrorCode OH_PreviewOutput_SetPreviewRotation(Camera_PreviewOutput* previewOutput, Camera_ImageRotation previewRotation, bool isDisplayLocked)
```

**描述**

设置相机预览旋转角度。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [Camera\_PreviewOutput](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-oh-camera-camera-previewoutput)\* previewOutput | 用于设置预览旋转角度的预览输出实例。 |
| [Camera\_ImageRotation](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-camera-h#camera_imagerotation) previewRotation | 预览的显示旋转角度。 |
| bool isDisplayLocked | Surface在屏幕旋转时是否锁定方向，未设置时默认取值为false，即不锁定方向。true表示锁定方向，false表示不锁定方向。详情请参考[SurfaceRotationOptions](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-components-xcomponent#surfacerotationoptions12对象说明)。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [Camera\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-camera-h#camera_errorcode) | CAMERA\_OK：方法调用成功。  CAMERA\_INVALID\_ARGUMENT：参数丢失或参数类型不正确。  CAMERA\_SERVICE\_FATAL\_ERROR：相机服务异常。 |

### OH\_PreviewOutput\_GetSupportedFrameRates()

PhonePC/2in1TabletTVWearable



```
1. Camera_ErrorCode OH_PreviewOutput_GetSupportedFrameRates(Camera_PreviewOutput* previewOutput, Camera_FrameRateRange** frameRateRange, uint32_t* size)
```

**描述**

获取支持的预览输出帧率列表。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [Camera\_PreviewOutput](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-oh-camera-camera-previewoutput)\* previewOutput | 传递支持的帧率列表的预览输出实例。 |
| [Camera\_FrameRateRange](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-oh-camera-camera-frameraterange)\*\* frameRateRange | 如果方法调用成功，将记录支持的预览输出帧率列表。 |
| uint32\_t\* size | 如果方法调用成功，将记录支持的预览输出帧率列表大小。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [Camera\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-camera-h#camera_errorcode) | CAMERA\_OK：方法调用成功。  CAMERA\_INVALID\_ARGUMENT：参数丢失或参数类型不正确。  CAMERA\_SERVICE\_FATAL\_ERROR：相机服务异常。 |

### OH\_PreviewOutput\_DeleteFrameRates()

PhonePC/2in1TabletTVWearable



```
1. Camera_ErrorCode OH_PreviewOutput_DeleteFrameRates(Camera_PreviewOutput* previewOutput, Camera_FrameRateRange* frameRateRange)
```

**描述**

删除帧率列表。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [Camera\_PreviewOutput](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-oh-camera-camera-previewoutput)\* previewOutput | 预览输出实例。 |
| [Camera\_FrameRateRange](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-oh-camera-camera-frameraterange)\* frameRateRange | 要删除的帧率列表。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [Camera\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-camera-h#camera_errorcode) | CAMERA\_OK：方法调用成功。  CAMERA\_INVALID\_ARGUMENT：参数丢失或参数类型不正确。 |

### OH\_PreviewOutput\_SetFrameRate()

PhonePC/2in1TabletTVWearable



```
1. Camera_ErrorCode OH_PreviewOutput_SetFrameRate(Camera_PreviewOutput* previewOutput, int32_t minFps, int32_t maxFps)
```

**描述**

设置预览输出帧率。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [Camera\_PreviewOutput](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-oh-camera-camera-previewoutput)\* previewOutput | 要设置帧率的预览输出实例。 |
| int32\_t minFps | 要设置的最小值。 |
| int32\_t maxFps | 要设置的最大值。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [Camera\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-camera-h#camera_errorcode) | CAMERA\_OK：方法调用成功。  CAMERA\_INVALID\_ARGUMENT：参数丢失或参数类型不正确。 |

### OH\_PreviewOutput\_GetActiveFrameRate()

PhonePC/2in1TabletTVWearable



```
1. Camera_ErrorCode OH_PreviewOutput_GetActiveFrameRate(Camera_PreviewOutput* previewOutput, Camera_FrameRateRange* frameRateRange)
```

**描述**

获取当前预览输出帧率。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [Camera\_PreviewOutput](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-oh-camera-camera-previewoutput)\* previewOutput | 传递当前预览输出帧率的预览输出实例。 |
| [Camera\_FrameRateRange](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-oh-camera-camera-frameraterange)\* frameRateRange | 如果方法调用成功，则将记录当前的[Camera\_FrameRateRange](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-oh-camera-camera-frameraterange)。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [Camera\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-camera-h#camera_errorcode) | CAMERA\_OK：方法调用成功。  CAMERA\_INVALID\_ARGUMENT：参数丢失或参数类型不正确。  CAMERA\_SERVICE\_FATAL\_ERROR：相机服务异常。 |

### OH\_PreviewOutput\_IsBandwidthCompressionSupported()

PhonePC/2in1TabletTVWearable



```
1. Camera_ErrorCode OH_PreviewOutput_IsBandwidthCompressionSupported(Camera_PreviewOutput* previewOutput, bool* isSupported)
```

**描述**

检查是否支持预览带宽压缩（指通过编码减少数据量，降低其在传输链路中的带宽占用）。

**起始版本：** 23

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [Camera\_PreviewOutput](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-oh-camera-camera-previewoutput)\* previewOutput | 预览输出实例。 |
| bool\* isSupported | 是否支持带宽压缩的结果。true表示支持，false表示不支持。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [Camera\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-camera-h#camera_errorcode) | CAMERA\_OK：方法调用成功。  CAMERA\_INVALID\_ARGUMENT：参数丢失或参数类型不正确。  CAMERA\_SERVICE\_FATAL\_ERROR：相机服务异常。 |

### OH\_PreviewOutput\_EnableBandwidthCompression()

PhonePC/2in1TabletTVWearable



```
1. Camera_ErrorCode OH_PreviewOutput_EnableBandwidthCompression(Camera_PreviewOutput* previewOutput, bool enabled)
```

**描述**

使能预览带宽压缩。

该接口只能在使用[OH\_CaptureSession\_CommitConfig()](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-capture-session-h#oh_capturesession_commitconfig)接口之前调用，否则会影响预览流出流格式。

**起始版本：** 23

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [Camera\_PreviewOutput](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-oh-camera-camera-previewoutput)\* previewOutput | 传递当前要预览带宽压缩使能的预览输出实例。 |
| bool enabled | 是否使能预览带宽压缩。true表示使能，false表示不使能。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [Camera\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-camera-h#camera_errorcode) | CAMERA\_OK：方法调用成功。  CAMERA\_OPERATION\_NOT\_ALLOWED: 操作不允许。  CAMERA\_INVALID\_ARGUMENT：参数丢失或参数类型不正确。  CAMERA\_SESSION\_NOT\_CONFIG：相机会话未配置。  CAMERA\_SERVICE\_FATAL\_ERROR：相机服务异常。 |

### OH\_PreviewOutput\_AddDeferredSurface()

PhonePC/2in1TabletTVWearable



```
1. Camera_ErrorCode OH_PreviewOutput_AddDeferredSurface(const Camera_PreviewOutput* previewOutput, const char* surfaceId)
```

**描述**

配置延迟预览的Surface。

**起始版本：** 24

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [const Camera\_PreviewOutput](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-oh-camera-camera-previewoutput)\* previewOutput | 添加surfaceId的预览输出实例。 |
| const char\* surfaceId | 用于创建Camera\_PreviewOutput实例的surfaceId。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [Camera\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-camera-h#camera_errorcode) | CAMERA\_OK：方法调用成功。  CAMERA\_INVALID\_ARGUMENT：参数丢失或参数类型不正确。 |