iOS应用中如何设置AR Quicklook直接进入「Object」视图模式

可以通过系统提供的配置实现打开AR功能时直接进入「Object」视图模式，该能力仅支持iOS 16及以上系统版本，更低版本无对应控制接口。

实现步骤 #

• 准备符合QuickLook要求的3D商品资源（通常为USDZ格式）
• 初始化QLPreviewController前，给待预览的QLPreviewItem设置默认显示模式属性，示例代码如下：

import QuickLook

// 加载本地商品USDZ资源，也可使用网络资源地址
guard let usdzPath = Bundle.main.path(forResource: "product_model", ofType: "usdz") else { return }
let previewItem = NSURL(fileURLWithPath: usdzPath) as QLPreviewItem

// iOS16+ 配置默认进入Object视图模式
if #available(iOS 16.0, *) {
    previewItem.setValue(QLPreviewItemDisplayMode.object.rawValue, forKey: "preferredDisplayMode")
}

// 正常加载QLPreviewController即可
let previewVC = QLPreviewController()
previewVC.dataSource = self
present(previewVC, animated: true)

额外配置说明 #

• 该配置仅修改默认启动模式，系统仍会保留顶部的AR/Object切换按钮，用户可自行切换查看模式
• 若需要完全禁止AR模式，仅保留Object视图，可额外添加以下配置：

if #available(iOS 16.0, *) {
    previewItem.setValue(true, forKey: "disableAR")
}

内容的提问来源于stack exchange，提问作者gstream