diff --git a/zh-cn/application-dev/reference/apis/js-apis-camera.md b/zh-cn/application-dev/reference/apis/js-apis-camera.md index 42d5c951e39b7a8f7ea28c82c5454770271c7369..23475b92e084d26815eedcd11de4cec322af51c2 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-camera.md +++ b/zh-cn/application-dev/reference/apis/js-apis-camera.md @@ -223,7 +223,6 @@ getSupportedOutputCapability(camera:CameraDevice): Promise | 使用Promise的方式获取结果,返回相机输出能力。 | - **示例:** ```js @@ -232,6 +231,66 @@ cameraManager.getSupportedOutputCapability(cameradevice).then((cameraoutputcapab }) ``` +### isCameraMuted + +isCameraMuted(): boolean + +查询相机是否被禁用,通过返回值返回结果。 + +**系统能力:** SystemCapability.Multimedia.Camera.Core + +**返回值:** + +| 类型 | 说明 | +| ---------- | -------------------------------------------- | +| boolean | 返回true表示相机被禁用,返回false表示相机未被禁用。 | + +**示例:** + +```js +let ismuted = await cameraManager.isCameraMuted(); +``` + +### isCameraMuteSupported + +isCameraMuteSupported(): boolean + +查询相机是否能被禁用,通过返回值返回结果。 + +**系统能力:** SystemCapability.Multimedia.Camera.Core + +**返回值:** + +| 类型 | 说明 | +| ---------- | ----------------------------- | +| boolean | 返回true表示相机可以被禁用,返回false表示相机不能被禁用。 | + +**示例:** + +```js +let ismutesuppotred = await cameraManager.isCameraMuteSupported(); +``` + +### muteCamera + +muteCamera(mute: boolean): void + +禁用相机。 + +**系统能力:** SystemCapability.Multimedia.Camera.Core + +**参数:** + +| 名称 | 类型 | 必填 | 说明 | +| -------- | --------------------------------- | ---- | ---------- | +| mute | boolean | 是 | 禁用相机。 | + +**示例:** + +```js +cameraManager.muteCamera(mute); +``` + ### createCameraInput createCameraInput(camera: CameraDevice, callback: AsyncCallback): void @@ -662,6 +721,32 @@ cameraManager.on('cameraStatus', (err, cameraStatusInfo) => { }) ``` +### on('cameraMute') + +on(type: 'cameraMute', callback: AsyncCallback): void + +禁用回调,通过注册回调函数获取相机禁用状态变化。 + +**系统能力:** SystemCapability.Multimedia.Camera.Core + +**参数:** + +| 名称 | 类型 | 必填 | 说明 | +| -------- | --------------- | ---- | --------- | +| type | string | 是 | 监听事件,固定为'cameraMute',即禁用状态变化事件。 | +| callback | boolean | 是 | 回调函数,用于获取禁用状态变化信息。 | + +**示例:** + +```js +cameraManager.on('cameraMute', (err, cameraStatusInfo) => { + if (err) { + console.error(`Failed to get cameraMute callback. ${err.message}`); + return; + } +}) +``` + ## CameraStatusInfo 相机管理器回调返回的接口实例,表示相机状态信息。