Stabilization继承自StabilizationQuery。
提供设备在录像模式下设置视频防抖的操作。
需要会话中有录像流(VideoOutput)的前提下,才可以对视频进行防抖设置。
getActiveVideoStabilizationMode(): VideoStabilizationMode
查询当前正在使用的视频防抖模式。
元服务API: 从API version 19开始,该接口支持在元服务中使用。
系统能力: SystemCapability.Multimedia.Camera.Core
返回值:
| 类型 | 说明 |
|---|---|
| VideoStabilizationMode | 视频防抖是否正在使用。若接口调用失败,返回undefined。 |
错误码:
以下错误码的详细介绍请参见Camera错误码。
| 错误码ID | 错误信息 |
|---|---|
| 7400103 | Session not config. |
示例:
import { BusinessError } from '@kit.BasicServicesKit';
function getActiveVideoStabilizationMode(videoSession: camera.VideoSession): camera.VideoStabilizationMode | undefined {
let vsMode: camera.VideoStabilizationMode | undefined = undefined;
try {
vsMode = videoSession.getActiveVideoStabilizationMode();
} catch (error) {
// 失败返回错误码error.code并处理。
let err = error as BusinessError;
console.error(`The getActiveVideoStabilizationMode call failed. error code: ${err.code}`);
}
return vsMode;
} setVideoStabilizationMode(mode: VideoStabilizationMode): void
设置视频防抖模式。需要先检查设备是否支持对应的防抖模式,可以通过isVideoStabilizationModeSupported方法判断所设置的模式是否支持。建议在commitConfig与Start之间设置视频防抖。
从API版本12开始,通过该接口设置HIGH视频防抖模式后,为保障多场景下的视频防抖表现,调用getActiveVideoStabilizationMode查询当前正在使用的视频防抖模式时,返回结果为AUTO模式,即自动进行选择防抖算法。
元服务API: 从API version 19开始,该接口支持在元服务中使用。
系统能力: SystemCapability.Multimedia.Camera.Core
参数:
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| mode | VideoStabilizationMode | 是 | 需要设置的视频防抖模式。 |
错误码:
以下错误码的详细介绍请参见Camera错误码。
| 错误码ID | 错误信息 |
|---|---|
| 7400103 | Session not config. |
示例:
import { BusinessError } from '@kit.BasicServicesKit';
function setVideoStabilizationMode(videoSession: camera.VideoSession): void {
try {
if (videoSession.isVideoStabilizationModeSupported(camera.VideoStabilizationMode.OFF)) {
videoSession.setVideoStabilizationMode(camera.VideoStabilizationMode.OFF);
}
} catch (error) {
// 失败返回错误码error.code并处理。
let err = error as BusinessError;
console.error(`The setVideoStabilizationMode call failed. error code: ${err.code}`);
}
}