文章

利用 AR 快速查看预览模型

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

概览

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

通过 AR 快速查看放置在现实环境中的虚拟吉他截屏。

选取输入格式

您可以采用 .usdz.reality 格式提供增强现实体验的内容:

在您的 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 浏览器中查看增强现实素材资源 (英文)”。

另请参阅

快速查看

class ARQuickLookPreviewItem (英文)

用于自定 AR 快速查看体验的对象。

在 AR 快速查看和 RealityKit 中添加视觉效果

利用建模策略,让增强现实体验在外观和性能之间取得平衡。

在 AR 快速查看中添加 Apple Pay 按钮或自定操作

提供一个横幅,让用户可在增强现实体验中轻点这个横幅来进行购买或完成自定操作。