本文指导开发者接入评估管理能力，完成开始评估、查询评估状态与结束评估的开发。Kit级能力范围与约束参见Automatic Scene Configuration Kit简介，名词定义参见Automatic Scene Configuration Kit术语。
评估管理模块提供以下能力：
进入评估模式后设备功能被大幅限制，为防止第三方应用滥用该能力，调用评估管理接口需申请权限ohos.permission.ASSESSMENT_CONFIGURATION。
表1 权限信息
| 权限名 | 权限级别 | 授权方式 | 应用开放范围 |
|---|---|---|---|
| ohos.permission.ASSESSMENT_CONFIGURATION | system_basic | 系统授权（system_grant） | 普通应用 |
该权限属于受限权限，需经审批后应用才可获得，申请方式参见申请受限权限。审批需同时满足以下规则：
其他约束如下：
评估配置的规格约束如下：
评估管理关键接口如下表所示，具体API说明详见@ohos.customization.assessment (评估管理)。
表2 评估管理接口功能介绍
| 接口名 | 描述 |
|---|---|
| begin(context, config, callback): void | 开始评估，弹出确认弹窗，用户确认后进入评估模式。 |
| end(context): void | 结束评估，解除评估模式下的系统能力限制。 |
| isActive(): boolean | 查询当前是否处于评估状态。 |
| getConfiguration(): AssessmentConfig | 获取当前评估配置。 |
在模块的module.json5文件中，申请权限ohos.permission.ASSESSMENT_CONFIGURATION。该权限为system_basic级别的系统授权（system_grant）受限权限，需先按申请受限权限完成申请，声明后在应用安装时自动授予。声明权限的详细说明参见声明权限。示例如下：
{
"module": {
// ...
"requestPermissions": [
// ...
{
"name": "ohos.permission.ASSESSMENT_CONFIGURATION"
}
]
}
} 导入assessment模块后即可调用评估管理接口。
import { assessment } from '@kit.AutomaticSceneConfigurationKit'; 配置评估参数，调用begin接口开始评估，并通过IAssessmentCallback注册评估过程回调。
调用begin后，系统会弹出确认弹窗，需用户确认后方可开始评估，评估结果及评估过程中的中断、结束事件均通过回调通知。context的获取方式参见Context的获取方式。示例代码如下：
import { common } from '@kit.AbilityKit';
import { assessment } from '@kit.AutomaticSceneConfigurationKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
const DOMAIN: number = 0xFF00;
const TAG: string = '[Sample_Assessment]';
// 评估过程回调
const assessmentCallback: assessment.IAssessmentCallback = {
onBegin: (error: assessment.AssessmentError): void => {
// AssessmentError.message为可选字段，取值前先做空值兜底
const message: string = error.message ?? '';
if (error.code === assessment.AssessmentErrorCode.OK) {
hilog.info(DOMAIN, TAG, '%{public}s', `onBegin, assessment began successfully, message: ${message}`);
} else {
hilog.error(DOMAIN, TAG, '%{public}s',
`onBegin, assessment begin failed, code: ${error.code}, message: ${message}`);
}
},
onInterrupted: (info: assessment.AssessmentInterruptInfo): void => {
// 评估被中断，业务侧可根据中断原因码做相应处理，如保存答题记录
hilog.warn(DOMAIN, TAG, '%{public}s', `onInterrupted, code: ${info.code}, message: ${info.message}`);
},
onEnd: (): void => {
hilog.info(DOMAIN, TAG, '%{public}s', 'onEnd, assessment ended');
}
};
@Entry
@Component
struct Index {
build() {
Button($r('app.string.begin_button'))
.onClick(() => {
this.beginAssessment();
})
}
private beginAssessment(): void {
// 请在组件内获取context，确保this.getUIContext().getHostContext()返回结果为UIAbilityContext
const host: common.Context | undefined = this.getUIContext().getHostContext();
if (host === undefined) {
hilog.error(DOMAIN, TAG, '%{public}s', 'begin failed, the host context is undefined');
return;
}
const context: common.UIAbilityContext = host as common.UIAbilityContext;
// 评估配置：最大时长1小时（3600000毫秒）；
// 评估期间允许运行包名为com.samples.assessment的应用
const config: assessment.AssessmentConfig = {
duration: 3600000,
allowedApps: ['com.samples.assessment']
};
try {
assessment.begin(context, config, assessmentCallback);
hilog.info(DOMAIN, TAG, '%{public}s', 'begin called, waiting for user confirmation');
} catch (error) {
const err: BusinessError = error as BusinessError;
hilog.error(DOMAIN, TAG, '%{public}s', `begin failed, code: ${err.code}, message: ${err.message}`);
}
}
} 在评估过程中，调用isActive接口查询当前评估状态，调用getConfiguration接口获取当前评估配置。示例代码如下：
import { assessment } from '@kit.AutomaticSceneConfigurationKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
const DOMAIN: number = 0xFF00;
const TAG: string = '[Sample_Assessment]';
try {
const active: boolean = assessment.isActive();
hilog.info(DOMAIN, TAG, '%{public}s', `isActive result: ${active}`);
if (active) {
const config: assessment.AssessmentConfig = assessment.getConfiguration();
hilog.info(DOMAIN, TAG, '%{public}s',
`getConfiguration result, duration: ${config.duration}, allowedApps: ${config.allowedApps.join(',')}`);
}
} catch (error) {
const err: BusinessError = error as BusinessError;
hilog.error(DOMAIN, TAG, '%{public}s', `query failed, code: ${err.code}, message: ${err.message}`);
} 评估完成后，由开启评估的应用调用end接口结束评估，系统解除评估模式下对系统能力的限制，并触发onEnd回调。示例代码如下：
import { common } from '@kit.AbilityKit';
import { assessment } from '@kit.AutomaticSceneConfigurationKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
const DOMAIN: number = 0xFF00;
const TAG: string = '[Sample_Assessment]';
@Entry
@Component
struct Index {
build() {
Button($r('app.string.exam_submit'))
.onClick(() => {
this.endAssessment();
})
}
// 结束由当前应用开启的评估，仅开启评估的应用可以结束该评估
private endAssessment(): void {
// 请在组件内获取context，确保this.getUIContext().getHostContext()返回结果为UIAbilityContext
const host: common.Context | undefined = this.getUIContext().getHostContext();
if (host === undefined) {
hilog.error(DOMAIN, TAG, '%{public}s', 'end failed, the host context is undefined');
return;
}
const context: common.UIAbilityContext = host as common.UIAbilityContext;
try {
assessment.end(context);
hilog.info(DOMAIN, TAG, '%{public}s', 'end called');
} catch (error) {
const err: BusinessError = error as BusinessError;
hilog.error(DOMAIN, TAG, '%{public}s', `end failed, code: ${err.code}, message: ${err.message}`);
}
}
} 评估模式由系统统一管控部分系统能力，但应用窗口形态、应用窗口的截屏录屏、剪贴板与输入法面板不在系统管控范围内，需由应用自行加固，防止评估内容外泄或借助外部输入作弊。建议在进入评估页面时统一启用，退出评估页面时恢复。
表3 应用侧加固措施
| 加固措施 | 接口 | 作用 |
|---|---|---|
| 窗口沉浸式 | setWindowLayoutFullScreen | 内容延伸至状态栏与导航栏区域，减少评估页面外的系统入口暴露 |
| PC全屏 | maximize | 主窗口进入全屏，且鼠标悬停热区不显示窗口标题栏与dock栏，减少借系统入口切出评估页面的可能 |
| 隐私模式 | setWindowPrivacyMode | 窗口无法被截屏与录屏，退至后台时在多任务视图中显示为隐私遮罩 |
| 清空剪贴板 | clearData | 清除残留的剪贴板数据，避免借助剪贴板传入答案 |
| 简单键盘模式 | setSimpleKeyboardEnabled | 输入法面板仅保留基础按键，收起候选栏与扩展功能入口，AI帮写功能随之不可用 |
PC全屏通过maximize接口实现，需传入MaximizePresentation.ENTER_IMMERSIVE_DISABLE_TITLE_AND_DOCK_HOVER（从API version 14开始支持），使主窗口进入全屏且鼠标悬停热区不显示窗口标题栏与dock栏；退出评估页面时调用recover接口，将窗口还原为进入全屏前的大小与位置。该接口仅在支持并处于自由窗口状态的设备上可正常调用，在支持但不处于自由窗口状态的设备及不支持自由窗口状态的设备上调用不生效也不报错，因此无需区分设备类型即可直接调用。
简单键盘模式通过inputMethod.setSimpleKeyboardEnabled接口开启，开启后输入法面板仅保留基础按键，候选栏与扩展功能入口被收起，AI帮写功能随之不可用，避免评估期间借助AI帮写生成答案。该设置对原生文本框组件在下次点击获焦时生效，对自绘控件在下次调用attach绑定输入法时生效，因此建议在进入评估页面后、考生开始作答前完成设置，并在退出评估页面时传入false恢复。
隐私模式需申请权限ohos.permission.PRIVACY_WINDOW，该权限为normal级别的系统授权（system_grant）权限，声明方式与申请权限一致。窗口类接口需先获取当前窗口，加固与恢复的关键实现如下：
import { common } from '@kit.AbilityKit';
import { window } from '@kit.ArkUI';
import { BusinessError, pasteboard } from '@kit.BasicServicesKit';
import { inputMethod } from '@kit.IMEKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
const DOMAIN: number = 0xFF00;
const TAG: string = '[Sample_Assessment]';
export class ExamHardeningUtil {
// 进入评估页面时启用全部加固措施
public static async applyHardening(context: common.UIAbilityContext): Promise<void> {
await ExamHardeningUtil.setWindowHardening(context, true);
ExamHardeningUtil.setSimpleKeyboard(true);
await ExamHardeningUtil.clearPasteboard();
}
// 退出评估页面时恢复窗口形态与输入法，并再次清空剪贴板
public static async releaseHardening(context: common.UIAbilityContext): Promise<void> {
await ExamHardeningUtil.setWindowHardening(context, false);
ExamHardeningUtil.setSimpleKeyboard(false);
await ExamHardeningUtil.clearPasteboard();
}
// 两项窗口措施分别捕获异常，单项失败不影响另一项生效
private static async setWindowHardening(context: common.UIAbilityContext, enable: boolean): Promise<void> {
let currentWindow: window.Window | undefined = undefined;
try {
currentWindow = await window.getLastWindow(context);
} catch (error) {
const err: BusinessError = error as BusinessError;
hilog.error(DOMAIN, TAG, '%{public}s', `getLastWindow failed, code: ${err.code}, message: ${err.message}`);
}
if (currentWindow === undefined) {
return;
}
try {
await currentWindow.setWindowLayoutFullScreen(enable);
} catch (error) {
const err: BusinessError = error as BusinessError;
hilog.error(DOMAIN, TAG, '%{public}s',
`setWindowLayoutFullScreen failed, code: ${err.code}, message: ${err.message}`);
}
try {
await currentWindow.setWindowPrivacyMode(enable);
} catch (error) {
const err: BusinessError = error as BusinessError;
hilog.error(DOMAIN, TAG, '%{public}s',
`setWindowPrivacyMode failed, code: ${err.code}, message: ${err.message}`);
}
}
// 输入法面板切换为简单键盘，仅保留基础按键，收起候选栏与扩展功能入口
private static setSimpleKeyboard(enable: boolean): void {
try {
inputMethod.setSimpleKeyboardEnabled(enable);
} catch (error) {
const err: BusinessError = error as BusinessError;
hilog.error(DOMAIN, TAG, '%{public}s',
`setSimpleKeyboardEnabled failed, code: ${err.code}, message: ${err.message}`);
}
}
// 清空剪贴板，避免残留数据被粘贴进评估页面
private static async clearPasteboard(): Promise<void> {
try {
await pasteboard.getSystemPasteboard().clearData();
} catch (error) {
const err: BusinessError = error as BusinessError;
hilog.error(DOMAIN, TAG, '%{public}s', `clearData failed, code: ${err.code}, message: ${err.message}`);
}
}
} 在评估页面的生命周期中调用加固与恢复，示例代码如下：
aboutToAppear(): void {
this.applyHardening();
}
aboutToDisappear(): void {
this.releaseHardening();
}
private applyHardening(): void {
const context: common.UIAbilityContext | undefined = this.getAbilityContext();
if (context === undefined) {
return;
}
ExamHardeningUtil.applyHardening(context).catch((error: BusinessError) => {
hilog.error(DOMAIN, TAG, '%{public}s', `applyHardening failed, code: ${error.code}, message: ${error.message}`);
});
} 完整实现参见相关实例。
调用begin接口后，设备弹出评估确认弹窗；用户确认后进入评估模式，系统能力受到限制，onBegin回调返回code为0（OK）。
调用isActive接口，返回true，表示当前处于评估状态。
尝试打开allowedApps白名单之外的应用，验证其无法在评估期间运行。
调用end接口结束评估，isActive接口返回false，系统能力限制解除，onEnd回调被触发。
allowedApps用于指定评估期间允许运行的应用包名，白名单之外的应用在评估期间无法运行。设计白名单时建议遵循以下原则：
duration为0时系统按默认时长处理，该默认时长与duration上限一致，达到该时长后评估因超时被中断并触发onInterrupted回调，中断原因码为TIMEOUT。具体取值参见约束与限制。
评估期间也可随时由开启评估的应用调用end接口主动结束评估，系统解除对系统能力的限制并触发onEnd回调。为避免评估长时间占用设备，建议按业务实际作答时长设置duration，具体操作参见结束评估。
onEnd与onInterrupted的触发时机不同：onEnd在应用调用end接口正常结束评估后触发；onInterrupted在评估被系统主动中断时触发，携带中断原因码与描述信息。
评估被中断时系统已自动解除对系统能力的限制，应用无需再调用end接口，建议完成以下处理：
begin接口调用成功后不会立即进入评估模式。系统会先弹出确认弹窗，需用户在弹窗中确认后设备才进入评估模式，用户取消则评估不会开始。
begin接口返回仅表示请求已提交，评估是否真正开始需通过onBegin回调判断：回调中code为OK表示评估已开始，为USER_CANCEL表示用户已取消。建议在onBegin回调中再更新界面状态并启动业务计时，配置方式参见开始评估。