RealityKit -什么是‘`steelBox`’实例加载？

Question

使用标准Xcode模板创建增强现实项目时，Xcode将此swift文件添加到项目中：

//
// Experience.swift
// GENERATED CONTENT. DO NOT EDIT.
//

import Foundation
import RealityKit
import simd
import Combine

public enum Experience {

    public enum LoadRealityFileError: Error {
        case fileNotFound(String)
    }

    private static var streams = [Combine.AnyCancellable]()

    public static func loadBox() throws -> Experience.Box {
        guard let realityFileURL = Foundation.Bundle(for: Experience.Box.self).url(forResource: "Experience", withExtension: "reality") else {
            throw Experience.LoadRealityFileError.fileNotFound("Experience.reality")
        }

        let realityFileSceneURL = realityFileURL.appendingPathComponent("Box", isDirectory: false)
        let anchorEntity = try Experience.Box.loadAnchor(contentsOf: realityFileSceneURL)
        return createBox(from: anchorEntity)
    }

    public static func loadBoxAsync(completion: @escaping (Swift.Result<Experience.Box, Swift.Error>) -> Void) {
        guard let realityFileURL = Foundation.Bundle(for: Experience.Box.self).url(forResource: "Experience", withExtension: "reality") else {
            completion(.failure(Experience.LoadRealityFileError.fileNotFound("Experience.reality")))
            return
        }

        var cancellable: Combine.AnyCancellable?
        let realityFileSceneURL = realityFileURL.appendingPathComponent("Box", isDirectory: false)
        let loadRequest = Experience.Box.loadAnchorAsync(contentsOf: realityFileSceneURL)
        cancellable = loadRequest.sink(receiveCompletion: { loadCompletion in
            if case let .failure(error) = loadCompletion {
                completion(.failure(error))
            }
            streams.removeAll { $0 === cancellable }
        }, receiveValue: { entity in
            completion(.success(Experience.createBox(from: entity)))
        })
        cancellable?.store(in: &streams)
    }

    private static func createBox(from anchorEntity: RealityKit.AnchorEntity) -> Experience.Box {
        let box = Experience.Box()
        box.anchoring = anchorEntity.anchoring
        box.addChild(anchorEntity)
        return box
    }

    public class Box: RealityKit.Entity, RealityKit.HasAnchoring {

        public var steelBox: RealityKit.Entity? {
            return self.findEntity(named: "Steel Box")
        }

    }

}

让我们关注代码的最后一部分

public class Box: RealityKit.Entity, RealityKit.HasAnchoring {
    public var steelBox: RealityKit.Entity? {
        return self.findEntity(named: "Steel Box")
    }
}

这部分显然是加载立方体，名为“钢盒”从标准Experience.rcproject。但是如果我将这个字符串重命名为没有出现在场景中的任意名称，多维数据集仍然加载良好，项目也是如此.在初始化过程中调用此方法！

为什么会这样呢？这到底是装不装？

Answer 1

Experience.swift文件中生成的内容直接链接到来自Reality Composer的场景。steelBox属性是RC场景中实体建模的“关键”。快速访问所需的模型是为了方便开发人员。

字符串"Steel Box"不是强制性的，而是可选的。你可以随便给你的模特取名字。但是，您甚至可以将这个字符串字段保持为空(在这种情况下，Xcode会为它分配一个长串字母和数字，或者只是一个empty string，而不是一个修改后的名称"Steel Box" --您将不会有steelBox属性)。

"Steel Box" name was automatically used to create `steelBox` property

因此，例如，如果在Reality Composer场景"Plastic Sphere"中命名了一个模型，它将自动创建一个名为plasticSphere的变量。

public var plasticSphere: Entity? { get }

在RealityKit中，您可以通过以下方式访问多维数据集实体：

 let boxAnchor = try! Experience.loadBox()
 arView.scene.anchors.append(boxAnchor)

 print(boxAnchor.steelBox!)

或使用其层次结构的下标：

 let boxAnchor = try! Experience.loadBox()
 arView.scene.anchors.append(boxAnchor)

 print(boxAnchor.children[0].children[0].children[0])

这导致打印实体的层次结构：

​

​

正如我们从控制台看到的，"Steel Box"只是一个steelBox的实体名称。

print(boxAnchor.steelBox!.name as Any)

// "Steel Box"

然而，正如我前面说过的，当您将这个字段空到模型的名称在现实作曲家.

​

​

...you无法从场景中检索实体的属性名。

您只能使用子层次结构检索它：

let boxAnchor = try! Experience.loadBox()
arView.scene.anchors.append(boxAnchor)

print(boxAnchor.children[0].children[0].children[0])

​

​

因此，正如我们所看到的，控制台中现在没有实体的名称(字符串是空的)。

但是你可以在任何时候分配它：

boxAnchor.steelBox!.name = "My favorite box"