10_利用 AR 快速查看预览模型

显示用户能够移动、缩放并与他人共享的模型或场景。

概览

借助 AR 快速查看，用户能够在 ARKit 从现实环境中找到的任何表面上放置您提供的虚拟内容。用户可以通过以下方式与您的虚拟内容进行互动：使用触控手势来移动和缩放虚拟内容，或者通过 iOS 共享列表来与他人共享。

选取输入格式

您可以采用 .usdz 或 .reality 格式提供增强现实体验的内容：
(1) 要浏览 .usdz 文件资料库，请参阅“AR 快速查看图库”。
(2) 要浏览 .reality 素材资源资料库，请使用 Reality Composer。

如果您在 App 的“拷贝文件”构建阶段附加了 Reality Composer 文件 (.rcproject)，那么 Xcode 会在构建时自动将转换后的 .reality 文件输出至您的 App 包。

在您的 App 中呈现增强现实体验

在您的 App 中，您可以通过向 QLPreviewController 提供受支持的输入文件来启用 AR 快速查看。下列代码演示了如何从 App 套装预览名为 myScene 的场景

import UIKit
import QuickLook
import ARKit

class ViewController: UIViewController, QLPreviewControllerDataSource {

    override func viewDidAppear(_ animated: Bool) {
        let previewController = QLPreviewController()
        previewController.dataSource = self
        present(previewController, animated: true, completion: nil)
    }

    func numberOfPreviewItems(in controller: QLPreviewController) -> Int { return 1 }

    func previewController(_ controller: QLPreviewController, previewItemAt index: Int) -> QLPreviewItem {
        guard let path = Bundle.main.path(forResource: "myScene", ofType: "reality") else { fatalError("Couldn't find the supported input file.") }
        let url = URL(fileURLWithPath: path)
        return url as QLPreviewItem
    }    
}

为了防止用户缩放您的虚拟内容或自定默认的分享列表行为，请使用 ARQuickLookPreviewItem 而非 QLPreviewItem 。

在您的网页中呈现增强现实体验

在您的网页中，您可以通过链接受支持的输入文件来启用 AR 快速查看。

<div>
    <a rel="ar" href="/assets/models/my-model.usdz">
        <img src="/assets/models/my-model-thumbnail.jpg">
    </a>
</div>

当用户在 Safari 浏览器中或者您的 App 所显示的网页视图中点按链接时，iOS 会替您在 AR 快速查看视图中呈现您的场景。有关更多信息，请参阅“在 iOS 版 Safari 浏览器中查看增强现实素材资源 (英文)”。