Zum Hauptinhalt springen
Diese Seite wurde automatisch übersetzt und kann Fehler enthalten. Original auf Englisch ansehen

Leitfaden für Unity

Mit unserem Unity SDK Plugin können Sie Haptik in Ihre mit Unity erstellten Inhalte integrieren.

  1. SDK Plugin importieren
  2. Haptische App verknüpfen
  3. Prefab zur Initialisierung hinzufügen

Anforderungen​

  • Entwicklungsumgebung
    • OS: Windows 10/11 (x64), macOS (Apple Silicon)
    • Unity 2022 und höher
    • bHaptics Player installiert
    • Eine bereitgestellte haptische Anwendung, die zu Ihrem Spiel passt
      • App ID und API Key der haptischen App
  • Laufzeitumgebung
    • OS: Windows 10/11 (x64), macOS (Apple Silicon), Android (nur VR-Headsets), PS5
      • Unterstützte Headsets: Meta Quest 2/3/3S/Pro, Pico 4/4 Pro/4 Ultra, HTC VIVE Focus 3/Focus Vision/XR Elite
      • Der bHaptics VR Player muss auf dem Headset installiert sein.
hinweis

Wenn Sie Unterstützung für eine ältere Unity-Version als 2022 benötigen, kontaktieren Sie uns unter support@bhaptics.com.

Deprecated Feature

Die Verwendung von bHaptics-Haptik-Geräten auf einem Standalone-VR-Headset ohne den auf dem Headset installierten bHaptics VR Player ist veraltet. Installieren Sie den bHaptics VR Player auf dem Headset, um die Haptik-Geräte zu verwenden.

Für macOS & Android

Wenn Sie für macOS und Android entwickeln, sind zusätzliche Anforderungen erforderlich, um das bHaptics SDK zu verwenden. Bitte prüfen Sie die folgenden Abschnitte.

About haptic application

You can create and manage haptic apps in Developer Portal, a web-based tool.

If you're unfamiliar with haptic apps or haven't created one yet, please follow the Portal guide before proceeding.

Before linking a haptic app to your game project, make sure the haptic app meets the following requirements:

  • At least one haptic event must be created.
  • API Key must be generated.
    • There is no API Key by default. To generate one, go to the "API Key" tab and click "New" button.
  • Haptic app must be deployed
    • If you see "Deploy Now" button in the upper right corner, click it to deploy your haptic app. Otherwise, if you can see "Up to date", it means that the latest haptic app has already been deployed.

Also, link process requires App ID and API Key. Go to the "Settings" tab, and check the App ID and API Key.

Check app ID, API key at the settings tab in Portal

SDK Plugin importieren​

bHaptics Haptic Plugin im Unity AssetStore

Holen Sie sich das bHaptics Haptic Plugin im Unity Asset Store und importieren Sie das Paket in Ihr Unity-Projekt.

Weitere Informationen zum Importieren des Unity-Pakets in Ihr Unity-Projekt finden Sie in der offiziellen Unity-Dokumentation.

Aktualisierung von einer früheren Version

Wenn Sie eine frühere Version des Unity-Pakets verwendet haben, löschen Sie nach der Aktualisierung diese veralteten Android-Bibliotheksdateien – löschen Sie jede .aar-Datei zusammen mit ihrer zugehörigen .meta-Datei:

  • bhaptics_ble.aar / bhaptics_ble.aar.meta
  • bhaptics_commons.aar / bhaptics_commons.aar.meta
  • bhaptics_core.aar / bhaptics_core.aar.meta

Sie werden vom aktuellen Paket nicht mehr verwendet und können durch doppelte Bibliotheken Android-Build-Fehler verursachen.

Haptische App verknüpfen​

  1. Wählen Sie in der Toolbar "bHaptics" → "Developer Window". Unity Toolbar
  2. Geben Sie Ihre App ID und Ihren API Key aus dem Portal ein und klicken Sie dann auf die Schaltfläche "LINK". bHaptics Developer Window Log-in
    hinweis

    Sie können "Forgot your App ID & API Key?" drücken, um das Portal zu besuchen und die Informationen abzurufen.

  3. Nach erfolgreicher Authentifizierung erscheint die Anwendung im bHaptics Developer Window.

App im bHaptics Developer Window durchsuchen​

bHaptics Developer Window

Es gibt mehrere Tabs, die Sie erkunden können.

  • Home: Den Beispielleitfaden und Informationen über Ihre Anwendung anzeigen.
  • Events: Die neuesten Events durchsuchen und abspielen, die Sie vom bHaptics Developer Portal bereitgestellt haben.
  • Documentation: Die Dokumente über das SDK durchsuchen (einschließlich dieser Seite!).
  • Latest Deployed Version: Die Version überprüfen oder aktualisieren.
    hinweis

    Stellen Sie sicher, dass die Version im Portal mit der Version im Editor übereinstimmt; falls nicht, drücken Sie das Aktualisierungssymbol.

  • Unlink: Die Verbindung zwischen dem Spiel und der haptischen App trennen.

Prefab zur Initialisierung hinzufügen​

Es gibt ein Prefab namens "[bhaptics]" zur Initialisierung der haptischen Umgebung. Es sollte instanziiert werden, bevor haptikbezogene Funktionen verwendet werden. Wir empfehlen dringend, es in der ersten Szene zu platzieren.

Prefab-Initialisierung

  1. Gehen Sie zu Ihrer ersten Szene.
  2. Gehen Sie im Project Window zu "Assets" → "Bhaptics" → "SDK2" → "Prefabs".
  3. Fügen Sie das "[bhaptics]"-Prefab zu Ihrer Szene hinzu.

Die Komponente in diesem Prefab verwendet das übliche Unity-Singleton-Pattern mit DontDestroyOnLoad. Sie müssen es nur in der ersten Szene platzieren, aber es ist in Ordnung, es an mehreren Stellen zu platzieren, da Duplikate automatisch zerstört werden.

Android Manifest aktualisieren​

Die Aktualisierung Ihrer AndroidManifest.xml ist erforderlich, wenn Sie Ihr Spiel für Standalone-Headsets (Android) erstellen. Da Android die Paket-Sichtbarkeit ab Target API Level 30 einschränkt, kann Ihr Spiel den bHaptics VR Player (das Paket com.bhaptics.player) ohne den unten stehenden Manifest-Eintrag nicht erkennen.

hinweis

Um das Android Target API Level des Projekts zu überprüfen, gehen Sie zu Project Settings → Player → Android settings(Android-Symbol) → Other Settings → Identification → Target API Level. Weitere Informationen finden Sie im Unity-Handbuch. Untitled

  1. Aktivieren Sie das Überschreiben des Android-App-Manifests. Gehen Sie zu Project Settings → Player → Android settings(Android-Symbol) → Publishing Settings → Build → Custom Main Manifest. Aktivieren Sie es dann, falls es deaktiviert ist. Das Verzeichnis der Manifest-Datei wird unten angezeigt. Untitled
  2. Öffnen Sie Ihre AndroidManifest.xml-Datei, die sich in der Regel im Verzeichnis Assets/Plugins/Android/ befindet.
  3. Fügen Sie das queries-Element zur Manifest-Datei hinzu. 
    <queries>
        <package android:name="com.bhaptics.player" />
    </queries>

Nach Abschluss des Vorgangs sollte die Manifest-Datei wie folgt aussehen.

<?xml version="1.0" encoding="utf-8"?>
<manifest
    xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.unity3d.player"
    xmlns:tools="http://schemas.android.com/tools">

    <application>
        <activity android:name="com.unity3d.player.UnityPlayerActivity"
            android:theme="@style/UnityThemeSelector">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
            <meta-data android:name="unityplayer.UnityActivity" android:value="true" />
        </activity>
    </application>

    <queries>
        <package android:name="com.bhaptics.player" />
    </queries>
</manifest>
hinweis

Weitere Informationen finden Sie in den folgenden Ressourcen.

gefahr

Wenn Sie die Minify-Option aktiviert haben, sollten Sie Ausnahmen zur Custom Proguard-Datei (proguard-user.txt) hinzufügen.

macOS Network Entitlement​

Unter macOS 15 (Sequoia) und höher läuft eine paketierte App innerhalb der App Sandbox. Die Sandbox blockiert jeglichen Netzwerkzugriff (einschließlich Verbindungen zu localhost), sofern die App nicht das Network-Client-Entitlement deklariert. Da das SDK über eine lokale Verbindung mit dem bHaptics Player kommuniziert, kann ein paketierter macOS-Build ohne dieses Entitlement keine Verbindung zum Player herstellen (Sie sehen möglicherweise, dass er mit einem "sandbox deny network"-Fehler fehlschlägt).

Wenn Sie Ihre App für macOS paketieren, fügen Sie das Entitlement com.apple.security.network.client hinzu. Dies wird vom App-Entwickler konfiguriert und ist nicht Teil des SDK.

Weiterführende Lektüre​

Sie sind jetzt bereit, die bHaptics-Haptik-Funktion zu verwenden! Besuchen Sie unsere Unity References-Seite, um Haptik in Ihrem Spiel abzuspielen.

hinweis

Wenn Sie jetzt sofort Haptik spüren möchten, stellen wir eine Beispielszene bereit, um die haptischen Events zu erkunden, die Sie testen können. Gehen Sie zu "Assets" → "Bhaptics" → "SDK2" → "Examples" → "Scenes" und öffnen Sie die Szene "PlayParamSample". Sie können alle haptischen Events abspielen und dabei die zugehörigen Parameter anpassen.

Troubleshooting​

Migrationsleitfaden​