在移动办公与数字创作日益普及的今天,手写笔已成为提升平板、手机等设备生产力的关键工具。然而,传统手写场景中,用户常因操作复杂(如频繁切换工具)、跨设备体验割裂等问题导致效率低下,而开发者则面临手势识别算法自研成本高、多端适配复杂等痛点。
为了提高操作的便捷性、效率和灵活性,减少用户在不同功能之间切换的时间和步骤,HarmonyOS SDK 手写笔服务(Pen Kit)新增了手写交互功能,支持第三方应用接入双击/轻捏功能。用户无需进入菜单或工具栏进行选择,只需简单操作即可切换工具,大大提高了工作效率。
应用场景
在教育领域,教师可通过双击切换板书工具或调出公式库,提升教学流畅性;办公场景中,用户通过双击撤销笔迹或轻捏调出快捷菜单,实现高效会议速记;创意设计中,双击切换笔刷、轻捏缩放画布等功能显著优化绘画与UI原型绘制效率;游戏场景中,轻敲笔身可提交指令或触发游戏内功能,增强沉浸感。
接入手写交互功能,对于需要接入支持双击/轻捏功能的手写笔的第三方应用,可以通过调用下面相应接口来监听手写笔双击/轻捏事件,从而触发自身应用内部回调,来执行指定操作。
-
监听手写笔轻捏事件: 开发者可以通过调用stylusInteraction.on('squeeze', receiver)接口来监听手写笔的轻捏事件。一旦检测到该事件,开发者可以触发相应的回调函数,执行特定的操作。例如,在绘图应用中,轻捏可以用来调整画笔粗细或颜色。
-
取消监听手写笔轻捏事件: 如果不再需要监听轻捏事件,开发者可以使用stylusInteraction.off('squeeze', receiver)来取消监听。这有助于优化应用性能,减少不必要的资源消耗。
-
监听手写笔双击事件: 类似地,通过调用stylusInteraction.on('doubleTap', receiver)接口,开发者可以监听手写笔的双击事件。这一功能特别适用于快速启动某些快捷操作,如打开工具栏或切换模式。
-
取消监听手写笔双击事件: 使用stylusInteraction.off('doubleTap', receiver)接口,开发者可以在不需要时取消对双击事件的监听,确保应用运行更加流畅高效。
开发步骤
手写笔轻捏事件
-
导入相关模块。
import { stylusInteraction} from '@kit.Penkit';
import { BusinessError } from '@kit.BasicServicesKit'; -
监听手写笔轻捏事件。
try {
stylusInteraction.on('squeeze', (event: stylusInteraction.SqueezeEvent) => {
console.info(got squeeze event, time: ${event.timestamp});
});
} catch (err) {
console.error('errCode: ' + (err as BusinessError).code + ', errMessage: ' + (err as BusinessError).message);
} -
取消监听手写笔轻捏事件。
try {
stylusInteraction.off('squeeze', (event: stylusInteraction.SqueezeEvent) => {
console.info(off squeeze event, time: ${event.timestamp});
});
} catch (err) {
console.error('errCode: ' + (err as BusinessError).code + ', errMessage: ' + (err as BusinessError).message);
}
手写笔双击事件
-
导入相关模块。
import { stylusInteraction} from '@kit.Penkit';
import { BusinessError } from '@kit.BasicServicesKit'; -
监听手写笔双击事件。
try {
stylusInteraction.on('doubleTap', (event: stylusInteraction.DoubleTapEvent) => {
console.info(got doubleTap event, time: ${event.timestamp});
});
} catch (err) {
console.error('errCode: ' + (err as BusinessError).code + ', errMessage: ' + (err as BusinessError).message);
} -
取消监听手写笔双击事件。
try {
stylusInteraction.off('doubleTap', (event: stylusInteraction.DoubleTapEvent) => {
console.info(off doubleTap event, time: ${event.timestamp});
});
} catch (err) {
console.error('errCode: ' + (err as BusinessError).code + ', errMessage: ' + (err as BusinessError).message);
}
了解更多详情>>
访问手写笔服务官网