阅读 1924

iOS14新特性 Apple Pencil中的随手写功能API介绍以及基本使用

一、介绍

iOS14 iPad 为Pencil新增了随手写功能,此功能可以实现不弹出键盘可以在指定区域去用手写笔去写字。

二、基本类

随手写功能主要有两个类

1. UIScribbleInteraction (可实现在textField、textView、等)
2. UIIndirectScribbleInteraction (可以在任何View上面,但必须要有第一相应者去接收)
复制代码

1. UIIndirectScribbleInteraction

想要实现撰写功能,则需要实现代理方法(类似UITableViewDelegate)

UIScribbleInteractionDelegate
复制代码

其代理方法有如下几个方法:

/// 指定那个区域可以使用随手写,并且设置唯一的ID。
- (void)indirectScribbleInteraction:(UIIndirectScribbleInteraction *)interaction requestElementsInRect:(CGRect)rect completion:(void(^)(NSArray<UIScribbleElementIdentifier> *elements))completion

// 确定可书写的范围
- (CGRect)indirectScribbleInteraction:(UIIndirectScribbleInteraction *)interaction frameForElement:(UIScribbleElementIdentifier)elementIdentifier;

// 聚焦到什么对象
- (void)indirectScribbleInteraction:(UIIndirectScribbleInteraction *)interaction focusElementIfNeeded:(UIScribbleElementIdentifier)elementIdentifier referencePoint:(CGPoint)focusReferencePoint completion:(void (^)(UIResponder<UITextInput> * _Nullable))completion

// 判断某个特定的元素是否被聚焦
- (BOOL)indirectScribbleInteraction:(UIIndirectScribbleInteraction *)interaction isElementFocused:(UIScribbleElementIdentifier)elementIdentifier

/// 是否延时聚焦
- (BOOL)indirectScribbleInteraction:(UIIndirectScribbleInteraction *)interaction shouldDelayFocusForElement:(UIScribbleElementIdentifier)elementIdentifier

/// 是否有笔迹将要书写
- (void)indirectScribbleInteraction:(UIIndirectScribbleInteraction *)interaction willBeginWritingInElement:(UIScribbleElementIdentifier)elementIdentifier

/// 是否书写完成
- (void)indirectScribbleInteraction:(UIIndirectScribbleInteraction *)interaction didFinishWritingInElement:(UIScribbleElementIdentifier)elementIdentifier
复制代码

三、基本使用

1.声明对象

@property (nonatomic, strong) UIIndirectScribbleInteraction *interaction;
复制代码

2.创建Interaction对象 签署代理,将当前View添加Interaction(本例中keyboradInputView为UIView)

self.interaction = [[UIIndirectScribbleInteraction alloc] initWithDelegate:self];
[self.keyboradInputView addInteraction:self.interaction];
复制代码

3.UIIndirectScribbleInteractionDelegate

/// 说明可写的区域
- (void)indirectScribbleInteraction:(UIIndirectScribbleInteraction *)interaction requestElementsInRect:(CGRect)rect completion:(void (^)(NSArray<UIScribbleElementIdentifier> * _Nonnull))completion  API_AVAILABLE(ios(14.0)){
    // 提供一个标识符 (类似UITableView的Indentifire, 但这里是唯一的,也不是缓存池那一套)
    completion(@[@"keyboradInputView.c_textInputViewIndetiner"]);
}
复制代码
// 确定可书写的范围
- (CGRect)indirectScribbleInteraction:(UIIndirectScribbleInteraction *)interaction frameForElement:(UIScribbleElementIdentifier)elementIdentifier  API_AVAILABLE(ios(14.0)){
    return [UIScreen mainScreen].bounds;
}
复制代码
// 聚焦到当前对象
- (void)indirectScribbleInteraction:(UIIndirectScribbleInteraction *)interaction focusElementIfNeeded:(UIScribbleElementIdentifier)elementIdentifier referencePoint:(CGPoint)focusReferencePoint completion:(void (^)(UIResponder<UITextInput> * _Nullable))completion  API_AVAILABLE(ios(14.0)){
    [self.keyboradInputView.c_textInputView becomeFirstResponder];
    completion(self.keyboradInputView.c_textInputView);
}
复制代码
// 标识某个特定的元素是否被聚焦
- (BOOL)indirectScribbleInteraction:(UIIndirectScribbleInteraction *)interaction isElementFocused:(UIScribbleElementIdentifier)elementIdentifier  API_AVAILABLE(ios(14.0)){
    return self.keyboradInputView.c_textInputView.isFirstResponder;
}
复制代码

四、UIScribbleInteraction

  • 和UIIndirectScribbleInteraction使用方式差不多,只是UIScribbleInteraction只能识别textField、textView 不过多赘述

五、注意

值得注意的是,iOS14 这个随手写功能,是弹不出虚拟键盘的,也收不到弹出虚拟键盘的通知 即:以下通知无效

UIKeyboardWillShowNotification 无效
UIKeyboardWillHideNotification 无效
复制代码
  • 随手写功能目前收不到类似上面的通知。
  • 随手写功能目前也获取不到用户是否开启/关闭随手写功能(只能看虚拟键盘是否弹出作为依据)

六、其他

  • 此文只给了思路,其实内部还就几个属性和API 感兴趣的朋友可以自己去看一下。目前国内外也没有啥博客可以参照。 看看官方文档,不难
文章分类
iOS
文章标签