ARkit -- hitTest(_ point:, optio

/*!
  @功能概述 : 返回包含指定点的每个节点的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节点所处的位置的相关信息

SCNHitTestResult

---

---

---

代码测试 :

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

打印结果 :

[<SCNHitTestResult: 0x1c0206f80 <0.070786,-0.468474,-1.241143> | geometryIndex=0 node=<SCNNode: 0x1c41f3f00 'shipMesh' pos(0.000000 -0.629630 -1.370018) scale(0.020000 0.020000 0.020000) | geometry=<SCNGeometry: 0x1c4130860 'Scrap_MeshShape'> | 1 child> bone=(null)>]

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

SCN容器
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比较多(矩阵没处理好,移动过程中突然消失),所以具体源代码,可以参考苹果的.这里只是演示一个效果.

效果图