nativeScript-wikitude

这是对 @breningham/nativescript-wikitude 的分支，不幸的是该项目已停止活跃。

提供对 Wikitude AR (Android 9.1.0 和 iOS 9.0.0) 的访问。

先决条件 / 要求

权限

在您可以使用此插件之前，您应该确保您的应用程序具有相机和位置的权限，为了在 android 和 ios 上方便地完成此操作，您可以使用此插件 @spartadigital/nativescript-permissions

运行演示

我们在演示应用程序中包含了一个非常基础的 AR 示例，

但如果您想从 wikitude 示例 检查更高级的功能并将其放置在 demo/app/wikitude 中... 然后，您可以在 Nativescript-angular 的 items.component.ts 或常规 Nativescript 的 main-view-model.ts 中更新 URL 引用。

然后前往 Wikitude 网站 获取试用许可证，并将其放置在 demo/app/main-view-model.ts 的第 13 行。

安装

要为您的项目安装，您可以使用

tns plugin add nativescript-wikitude

对于 Nativescript Angular 项目，您需要在您的 app.component.ts 中导入元素

import { Wikitude } from "nativescript-wikitude";
// ...snip....
registerElement("Wikitude", () => Wikitude);

然后在您的 ar.component.html 中

<Wikitude
  [url]="WikitudeURL"
  (WorldLoaded)="onWorldLoaded($event)"
  (JSONReceived)="onJSON($event)"
>
</Wikitude>

在您的 ar.component.ts 中

    import { Wikitude } from 'nativescript-wikitude';

    // ...snip...

    WikitudeInstance: Wikitude;
    WikitudeURL: string = "~/wikitude_world/index.html";

    onWorldLoaded($event) {
        this.WikitudeInstance = $event.owner; // or you can use Angular's ViewChild
    }

    onJSON($event) {
        console.log(JSON.stringify($event.data));
    }

    // ...snip...

并在您的应用程序的某个位置定义 Wikitude 许可证，您可以从 wikitude 获取一个（免费试用许可证）

    (global as any).wikitudeLicense: string = "YOUR_LICENSE_KEY_HERE"

然后，您就可以在 Nativescript 应用程序中使用 Wikitude AR 了！

使用

使用您自己的位置提供者

默认情况下，此插件具有基本的位置提供者，如果这不适合您的目的，您可以在完全加载后禁用它，以下代码可以做到这一点

    onWorldLoaded($event) {
        this.WikitudeInstance = $event.owner; // or you can use Angular's ViewChild
        this.WikitudeInstance.disableLocationProvider();
    }

禁用后，基于地理位置的 AR 将不会工作，除非您提供自己的位置，这可以通过以下方式实现

this.WikitudeInstance.setLocation({ latitude, longitude, altitude, accuracy });

这对于您想要一个单一的位置状态很有用。

禁用后，您可以使用以下方式重新启用它

this.WikitudeInstance.enableLocationProvider();

TODO

• 插件 API 暴露，不确定如何进行，Wikitude 允许使用其插件 API (例如，人脸识别) 来使用内置的 CPP 插件。我不确定如何允许用户这样做。任何建议都将受到欢迎...
• 检测设备是否需要校准：目前由于 Android 导致崩溃，当我尝试监听此事件时。
• 相机事件：对于开发者来说，检查相机打开、关闭和任何崩溃可能很有用。
• 更好的方式来设置 Wikitude LicenseKey 和必需功能。

API

属性

函数

事件

所有内容都可以从 index.d.ts 中导入。

许可证

Wikitude 是 (c) Wikitude GmbH 在使用前请参阅他们的 最终用户许可协议

Apache 许可证版本 2.0，2004 年 1 月