屏幕

has.setVisualEffectOnCapture

has.setVisualEffectOnCapture(Object object)

设置截屏/录屏时屏幕表现，设置元服务窗口不可截屏/录屏。仅在当前元服务处于前台状态下生效，其他未配置的元服务或窗口不生效。

起始版本： 2.0.1

需要权限：在module.json5文件中声明ohos.permission.PRIVACY_WINDOW。

约束与限制：

当前接口在元服务被嵌入式运行时暂不支持使用，建议规避或替换类似功能接口。

参数：

参数为Object对象，包括以下字段。

错误码信息：

示例：

has.setVisualEffectOnCapture({
  visualEffect: 'hidden',
  success: () => {
    console.info('setVisualEffectOnCapture success.');
  },
  fail: (err) => {
    console.error('setVisualEffectOnCapture fail:', err);
  },
  complete: (res) => {
    console.info('setVisualEffectOnCapture complete.', res);
  }
});

has.setScreenBrightness

has.setScreenBrightness (Object object)

设置屏幕亮度。仅在当前元服务生效，离开元服务后设置失效。

起始版本： 1.0.4

约束与限制：

当前接口在元服务被嵌入式运行时暂不支持使用，建议规避或替换类似功能接口。

参数：

参数为Object对象，包括以下字段。

错误码信息：

示例：

has.setScreenBrightness({
  value: 0.5,
  success:() => {
    console.info('setScreenBrightness success');
  },
  fail: (err) => {
    console.error('setScreenBrightness fail', err)
  },
  complete: (res) => {
    console.info('setScreenBrightness complete', res);
  }
});

has.setKeepScreenOn

has.setKeepScreenOn (Object object)

设置屏幕是否保持常亮状态。仅在当前元服务生效，离开元服务后设置失效。

起始版本： 1.0.4

约束与限制：

当前接口在元服务被嵌入式运行时暂不支持使用，建议规避或替换类似功能接口。

参数：

参数为Object对象，包括以下字段。

错误码信息：

示例：

has.setKeepScreenOn({
  keepScreenOn: true,
  success: () => {
    console.info('setKeepScreenOn success');
  },
  fail: (err) => {
    console.error('setKeepScreenOn fail', err);
  },
  complete: (res) => {
    console.info('setKeepScreenOn complete', res);
  }
});

has.onUserCaptureScreen

has.onUserCaptureScreen (function callback)

监听用户主动截屏事件。用户使用系统截屏按键截屏时触发，只能注册一个监听。

起始版本： 1.0.4

约束与限制：

当前接口在元服务被嵌入式运行时暂不支持使用，建议规避或替换类似功能接口。

参数：

错误码信息：

示例：

has.onUserCaptureScreen(function() {
  console.info('监听用户截屏事件');
});

has.offUserCaptureScreen

has.offUserCaptureScreen (function callback)

取消监听用户主动截屏事件。

起始版本： 1.0.4

约束与限制：

当前接口在元服务被嵌入式运行时暂不支持使用，建议规避或替换类似功能接口。

参数：

错误码信息：

示例：

const fun = () => {
  console.info('screenshotCallback');
};

has.onUserCaptureScreen(fun);
has.offUserCaptureScreen(fun);

has.getScreenBrightness

has. getScreenBrightness (Object object)

获取元服务应用当前屏幕亮度。

起始版本： 1.0.4

约束与限制：

当前接口在元服务被嵌入式运行时暂不支持使用，建议规避或替换类似功能接口。

参数：

参数为Object对象，包括以下字段。

success返回值：

错误码信息：

示例：

has.getScreenBrightness({
  success: (res) => {
    console.info('getScreenBrightness success', res);
  },
  fail: (err) => {
    console.error('getScreenBrightness fail', err);
  },
  complete: (res) => {
    console.info('getScreenBrightness complete', res);
  }
});