OmniVirt AR SDK for iOS

OmniVirt AR 是一款面向营销和广告的增强现实解决方案。此 SDK 使出版商和应用程序开发者能够在 iOS 平台上将沉浸式 AR 广告体验集成到他们的应用中。

请访问我们的网站 www.omnivirt.com 了解更多，或通过电子邮件 [email protected] 联系我们。

预览视频

需求

• iOS 11.0+
• Xcode 9.2+
• Swift 4+

安装

CocoaPods

CocoaPods 是 Cocoa 项目的依赖管理器。它是将 OmniVirtAR SDK 添加到应用程序的最便捷方式。您可以使用以下命令安装它：

$ gem install cocoapods

要使用 CocoaPods 将 OmniVirtAR 集成到您的 Xcode 项目中，请在您的 Podfile 中指定它：

source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '11.0'
use_frameworks!

target '<Your Target Name>' do
    pod 'OmniVirtAR-iOS-SDK'
end

然后，运行以下命令

$ pod install

Xcode 项目设置

在您的 Xcode 项目中，打开您的 Info.plist 文件，将 arkit 添加到 UIRequiredDeviceCapabilities 中，并添加带有描述的 NSCameraUsageDescription，以便您的应用程序可以使用摄像头进行增强现实。

<key>UIRequiredDeviceCapabilities</key>
<array>
    <string>armv7</string>
    <string>arkit</string>
</array>
<key>NSCameraUsageDescription</key>
<string>This app will use the camera for AR experience</string>

用法

目前有两种方法可以启动 AR 广告。第一种方法是调用我们的 API 手动展示。另一种方法是当用户点击一个使用 OmniVirt 的自定义 URL 规约的特殊链接时启动它（从一个外部应用程序或网络浏览器）。然后，它将用户导航到您的应用程序，SDK 会自动展示 AR 广告。

1) 手动展示 AR 广告

1. 导入模块

   import OmniVirtAR

2. 根据 adUnitID 创建一个 OVARInterstitial 的实例，然后调用 present 方法以启动

   let adView = OVARInterstitial(adUnitID: "25")
   adView.present()

   注意：您可以从 OmniVirt 广告活动平台获取广告的 adUnitID 值。

2) 使用自定义 URL 规约的链接自动展示 AR 广告

1. 打开 Info.plist 并插入以下内容：

   <key>CFBundleURLTypes</key>
   <array>
       <dict>
       <key>CFBundleURLName</key>
       <string>com.omnivirt.app.APP_ID</string>
       <key>CFBundleURLSchemes</key>
       <array>
           <string>omnivirt-APP_ID</string>
       </array>
       </dict>
   </array>

   您必须用您自己的应用ID替换APP_ID。您可以通过在OmniVirt注册您的应用程序来获得自己的应用ID。

2. 在您的AppDelegate中插入以下代码行

   func application(_ app: UIApplication, open url: URL, options:[UIApplicationOpenURLOptionsKey : Any] = [:]) -> Bool {
       return OVARLauncher.shared.openURL(url, options)
   }

3. 要测试它，请在您的手机上打开网页浏览器，并输入您的广告单元的URL。例如，如果您应用程序的ID为12345，广告单元ID为25，则您的URL可能是这样的：omnivirt-12345://adunit?id=25。当您输入此URL并点击“前往”按钮时，它将导航您到您的应用程序，并自动启动SDK中的AR广告。

有问题？

请通过以下电子邮件联系我们：[email protected]