ARkit -- hitTest(_ point:, options:)

/*!
  @功能概述 : 返回包含指定点的每个节点的SCNHitTestResult数组。
  @参数 point : 接收器坐标系中的一个点。
  @参数 options : 可选参数（有关可用选项，请参阅“命中测试选项”组）。
 */
public func hitTest(_ point: CGPoint, options: [SCNHitTestOption : Any]? = nil) -> [SCNHitTestResult]

点击类型 : SCNHitTestOption

extension SCNHitTestOption {
    public static let clipToZRange：SCNHitTestOption
    public static let backFaceCulling：SCNHitTestOption     //如果设置为YES，则忽略不面向相机的面。默认为YES。
    public static let boundingBoxOnly：SCNHitTestOption     //如果设置为YES，则仅测试3D对象的边界框。默认为NO。
    public static let ignoreChildNodes：SCNHitTestOption    //确定子节点是否被忽略。默认为NO。
    public static let rootNode：SCNHitTestOption            //指定用于命中测试的根节点。默认为场景的根节点。
    public static let ignoreHiddenNodes：SCNHitTestOption   //确定隐藏节点是否应该被忽略。默认为YES。
    @available（iOS 10.0，*）
    public static let categoryBitMask：SCNHitTestOption     //确定要测试的节点类别。默认为所有位设置。
    @available（iOS 11.0，*）
    public static let searchMode：SCNHitTestOption          //确定搜索是否是穷尽的。默认为SCNHitTestSearchModeClosest。
    public static let firstFoundOnly：SCNHitTestOption      //已弃用，请改用SCNHitTestOptionSearchMode选项使用SCNHitTestOptionSearchModeAny
    public static let sortResults：SCNHitTestOption         //已弃用，请改用SCNHitTestOptionSearchMode选项使用SCNHitTestSearchModeAll
}

返回结果 : SCNHitTestResult

SCNHitTestResult关于AR节点所处的位置的相关信息

ARkit -- hitTest(_ point:, options:)_第1张图片

SCNHitTestResult

代码测试 :

extension ViewController {
    override func touchesBegan(_ touches: Set, with event: UIEvent?) {
        let touchPoint = touches.first!.location(in: sceneView)
        let result = sceneView.hitTest(touchPoint, options: nil)
        print(result)
    }
}

打印结果 :

[ | geometryIndex=0 node= | 1 child> bone=(null)>]

点击AR对象才有结果返回,shipMesh是AR节点的名字
1 child表示只根节点中只有一个子节点

ARkit -- hitTest(_ point:, options:)_第2张图片

SCN容器

ARkit -- hitTest(_ point:, options:)_第3张图片

SCN容器

PS : 这里面需要注意的是

1.一个SCN文件中,一个根节点下一般存在多个子节点(如下图).要操作完整的AR对象的话要取rootNode.
2.这里的点击方法只有当点击检测到AR节点的时候才会返回结果.
3.点击类型设置,一般为键值对,比如 :
sceneView.hitTest(touchPoint, options: [.boundingBoxOnly:true] )
4.研究过苹果官方的ARkit源代码,也是通过这个方法来操作AR对象的.

多个AR节点

小总结 :
我们这里什么时候用到hitTest(_ point:, options:), 这个功能的概述是 :
返回包含指定点的每个节点的SCNHitTestResult数组。 (每个节点)
返回包含指定点的每个节点的SCNHitTestResult数组。 (每个节点)
返回包含指定点的每个节点的SCNHitTestResult数组。 (每个节点)

也就是当前点击的位置对应的节点信息.

对比ARkit -- hitTest(_ point:, types:)你可以大概清楚知道

检测可用的AR平面来做AR平面的事情用 : hitTest(_ point:, types:).
操作可用的AR节点对象来做平移旋转缩放的事情用 : hitTest(_ point:, options:)

PS : 这里面的理解只是我个人的非常非常浅显的(小白)理解.非专业.参考参考就好

操作AR对象

参照苹果官方代码,模拟测试的一个小的Demo.因为bug比较多(矩阵没处理好,移动过程中突然消失),所以具体源代码,可以参考苹果的.这里只是演示一个效果.

效果图