提供统一的安全审计数据订阅与取消订阅接口，应用可以获取设备上的安全审计数据，以支撑审计业务。

起始版本： 5.0.0(12)

导入模块

import { securityAudit } from '@kit.DeviceSecurityKit';

AuditEventInfo

用于订阅或取消订阅接口的请求参数。

系统能力： SystemCapability.Security.SecurityAudit

起始版本： 5.0.0(12)

名称	类型	只读	可选	说明
eventId	number	否	否	审计事件ID，用于指定需要获取的安全审计数据。例如：0x810800800审计事件ID的取值范围是[0, 0xFFFFFFFFF]。

AuditEvent

安全审计数据。

系统能力： SystemCapability.Security.SecurityAudit

起始版本： 5.0.0(12)

名称	类型	只读	可选	说明
eventId	number	否	否	审计事件ID，与请求参数中的审计事件ID相同。
version	string	否	是	审计事件版本号。
timestamp	string	否	是	审计事件发生时间。格式为： YYYYMMDDHHMMSS
content	string	否	是	审计事件内容。不同审计事件具备不同的内容，内容为json格式字符串。例如：{“type”: 1}
userId	number	否	是	发生审计事件时，登录的用户ID。
deviceId	string	否	是	审计事件发生的设备Id。

on(“auditEventOccur”)

on(type: ‘auditEventOccur’, auditEventInfo: [AuditEventInfo], callback: Callback<[AuditEvent]>): void

订阅安全审计数据。

需要权限： ohos.permission.QUERY_AUDIT_EVENT

系统能力： SystemCapability.Security.SecurityAudit

起始版本： 5.0.0(12)

参数：

参数名	类型	必填	说明
type	string	是	订阅的事件类型名称，固定值 ‘auditEventOccur’，表示审计事件。
auditEventInfo	[AuditEventInfo]	是	订阅的审计数据信息。
callback	Callback<[AuditEvent]>	是	用于接收审计事件的回调函数。

错误码ID	错误信息
201	check permission fail.
401	invalid parameters.Possible causes:1. Mandatory parameters are left unspecified.2. Incorrect parameter types.3. Parameter verification failed.

示例：

import { securityAudit } from '@kit.DeviceSecurityKit';
import { BusinessError} from '@kit.BasicServicesKit';
import { hilog } from '@kit.PerformanceAnalysisKit';

const TAG = "SecurityAuditAuditJsTest";
const callback = (event: securityAudit.AuditEvent) => {
  hilog.info(0x0000, TAG, '%{public}s', 'Security_SecurityAudit_JsApi_Func eventId= ' + event.eventId);
  hilog.info(0x0000, TAG, '%{public}s', 'Security_SecurityAudit_JsApi_Func version= ' + event.version);
  hilog.info(0x0000, TAG, '%{public}s', 'Security_SecurityAudit_JsApi_Func content= ' + event.content);
  hilog.info(0x0000, TAG, '%{public}s', 'Security_SecurityAudit_JsApi_Func timestamp= ' + event.timestamp);
  hilog.info(0x0000, TAG, '%{public}s', 'Security_SecurityAudit_JsApi_Func userId= ' + event.userId);
  hilog.info(0x0000, TAG, '%{public}s', 'Security_SecurityAudit_JsApi_Func deviceId= ' + event.deviceId);
};
let auditEventInfo: securityAudit.AuditEventInfo = {
   eventId: 0x810800800
};

try {
  hilog.info(0x0000, TAG, 'on begin.');
  securityAudit.on('auditEventOccur', auditEventInfo, callback);
  hilog.info(0x0000, TAG, 'Succeeded in on.');
} catch (err) {
  let e: BusinessError = err as BusinessError;
  hilog.error(0x0000, TAG, 'on failed: %{public}d %{public}s', e.code, e.message);
}

off(“auditEventOccur”)

off(type: ‘auditEventOccur’, auditEventInfo: [AuditEventInfo], callback?: Callback<[AuditEvent]>): void

取消订阅安全审计数据。

需要权限： ohos.permission.QUERY_AUDIT_EVENT

系统能力： SystemCapability.Security.SecurityAudit

起始版本： 5.0.0(12)

参数：

参数名	类型	必填	说明
type	string	是	取消订阅的事件类型名称，固定值 ‘auditEventOccur’，表示审计事件。
auditEventInfo	[AuditEventInfo]	是	取消订阅的审计数据信息。
callback	Callback<[AuditEvent]>	否	用于接收审计数据的回调函数。如果传入了 callback，则取消该callback的订阅，否则取消所有callback的订阅。

错误码ID	错误信息
201	check permission fail.
401	Invalid parameters.Possible causes:1. Mandatory parameters are left unspecified.2. Incorrect parameter types.3. Parameter verification failed.

示例：

import { securityAudit } from '@kit.DeviceSecurityKit';
import { BusinessError} from '@kit.BasicServicesKit';
import { hilog } from '@kit.PerformanceAnalysisKit';

const TAG = "SecurityAuditAuditJsTest";
let auditEventInfo: securityAudit.AuditEventInfo = {
   eventId: 0x810800800
};

try {
  hilog.info(0x0000, TAG, 'off begin.');
  securityAudit.off('auditEventOccur', auditEventInfo);
  hilog.info(0x0000, TAG, 'Succeeded in off.');
} catch (err) {
  let e: BusinessError = err as BusinessError;
  hilog.error(0x0000, TAG, 'off failed: %{public}d %{public}s', e.code, e.message);
}

最后呢

很多开发朋友不知道需要学习那些鸿蒙技术？鸿蒙开发岗位需要掌握那些核心技术点？为此鸿蒙的开发学习必须要系统性的进行。

而网上有关鸿蒙的开发资料非常的少，假如你想学好鸿蒙的应用开发与系统底层开发。你可以参考这份资料，少走很多弯路，节省没必要的麻烦。由两位前阿里高级研发工程师联合打造的《鸿蒙NEXT星河版OpenHarmony开发文档》里面内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（Harmony NEXT）技术知识点

如果你是一名Android、Java、前端等等开发人员，想要转入鸿蒙方向发展。可以直接领取这份资料辅助你的学习。下面是鸿蒙开发的学习路线图。

针对鸿蒙成长路线打造的鸿蒙学习文档。话不多说，我们直接看详细鸿蒙（OpenHarmony ）手册（共计1236页）与鸿蒙（OpenHarmony ）开发入门视频，帮助大家在技术的道路上更进一步。

• 《鸿蒙 (OpenHarmony)开发学习视频》
• 《鸿蒙生态应用开发V2.0白皮书》
• 《鸿蒙 (OpenHarmony)开发基础到实战手册》
• OpenHarmony北向、南向开发环境搭建
• 《鸿蒙开发基础》
• 《鸿蒙开发进阶》
• 《鸿蒙开发实战》

总结

鸿蒙—作为国家主力推送的国产操作系统。部分的高校已经取消了安卓课程，从而开设鸿蒙课程；企业纷纷跟进启动了鸿蒙研发。

并且鸿蒙是完全具备无与伦比的机遇和潜力的；预计到年底将有 5,000 款的应用完成原生鸿蒙开发，未来将会支持 50 万款的应用。那么这么多的应用需要开发，也就意味着需要有更多的鸿蒙人才。鸿蒙开发工程师也将会迎来爆发式的增长，学习鸿蒙势在必行！ 自↓↓↓拿