Freigeben über


Hinzufügen von WebSlate zu Ihrer Umgebung

Übersicht

Anzeigen und Interagieren mit webinhaltsübersicht

Im Mesh-Toolkit wird webSlate Prefab, das wir verwenden möchten, als WebSlateFramed bezeichnet. Er enthält einen URL-Parameter, den Sie angeben können, um den Inhalt zu steuern, den webSlate anzeigt. Sie enthält auch eine Komponente, mit der eine Ereignisorganisation die URL für das WebSlate in einem Ereignis in Echtzeit ändern kann. Wenn ein Mesh-Ereignis, das webSlate enthält, gestartet wird, lädt webSlate den Inhalt mithilfe der von Ihnen bereitgestellten URL.

Hinweise

  • Es gibt auch ein Prefab mit dem Namen WebSlate im Mesh-Toolkit, unterstützt jedoch nicht die Aktualisierung der URL in einem Mesh-Ereignis in Echtzeit, sodass wir es nicht empfehlen.

  • Die Größe und Form des WebSlate stimmt mit dem des quad GameObject überein, auf dem es platziert wird. In der Regel ist dies das Quad, das im WebSlate-Prefab gebacken wird.

  • Sie können einer Szene mehrere WebSlates hinzufügen. Die Anzahl der Benutzer in einem Mesh-Ereignis, das auf Mesh basiert, wirkt sich nicht auf die WebSlate-Leistung aus. WebSlate-Ressourcen werden lokal auf dem Computer des Benutzers initialisiert.

Hinzufügen eines WebSlates

Hinzufügen des WebSlateFramed-Prefab aus einem Menü

  1. Klicken Sie mit der rechten Maustaste in die Hierarchie, und wählen Sie dann im Kontextmenü das Mesh Toolkit>WebSlateFramed aus.

    Tipp: Sie können auch oben links im Hierarchiefenster auf die Schaltfläche "+" klicken, um dasselbe Menü anzuzeigen.

    Screenshot der Liste der Ergebnisse, nachdem WebSlate durchsucht wurde.

Suchen und Hinzufügen des WebSlateFramed Prefab

  1. Geben Sie im Suchfeld "WebSlateFramed" ein. Stellen Sie sicher, dass der Filter "Alle " ausgewählt ist.

    Screenshot der Liste der Ergebnisse, nachdem WebSlate durchsucht wurde.

  2. Ziehen Sie das gewünschte Prefab in die Szenenansicht oder die Hierarchie.

Angeben der Standard-URL

  1. Erweitern Sie in der Hierarchie das WebSlateFramed GameObject, und wählen Sie dann das untergeordnete Objekt mit dem Namen WebSlate aus.

    Screenshot des untergeordneten WebSlateFramed-Objekts mit dem Namen

  2. Navigieren Sie im Inspektor zur WebSlate-Komponente .

  3. Aktualisieren Sie das Feld " Aktuelle URL " auf die URL, die webSlate standardmäßig in einem Mesh-Ereignis laden soll.

    Screenshot des Felds

WebSlate in einem Ereignis steuerbar machen

Wenn Sie Ihrer Umgebung ein WebSlate hinzufügen, legen Sie dafür eine Standard-URL fest, aber was geschieht, wenn ein Ereignisorganisator die URL während eines Ereignisses mithilfe der Systemsteuerung in Echtzeit ändern möchte? Um dies zu berücksichtigen, enthält das WebSlateFramed Prefab eine Komponente mit dem Namen WebSlate Controllable. Es ist auch mit der Objektsteuerungskomponente enthalten, mit der ein Ereignisorganisator das WebSlate während eines Ereignisses aktivieren oder deaktivieren kann.

Das steuerbare Feature von WebSlates ermöglicht es Umgebungserstellern, das Design und die Ästhetik der Umgebung beizubehalten, während Organisatoren, die mehrere Ereignisse ausführen (als Vorlage oder nicht), inhalte je nach Design ihres Ereignisses ändern können. Beachten Sie, dass steuerbare URLs nur während Liveereignissen hinzugefügt oder geändert werden können. URLs, die während der Anpassung (im Bearbeitungsmodus) hinzugefügt wurden, werden nicht gespeichert und werden daher nicht über mehrere Ereignisse hinweg beibehalten. WebSlates verwenden standardmäßig die URL, die Entwickler in Unity jedes Mal hinzugefügt haben.

Mit diesem Feature bieten WebSlates die folgenden Funktionen:

  • Ereignisorganisatoren: Umschalten von URLs, Sichtbarkeit (ein/aus) und (optional) Anhalten verhindern (um WebSlates immer aktiviert zu halten). Organisatoren können den Hostbereich verwenden, um während eines Ereignisses eine URL zu ändern; dadurch werden WebSlates für alle Benutzer sofort aktualisiert (globale Aktualisierung). 
  • Ereignisteilnehmer: Wenn ein Teilnehmer den Cursor oder Den Controller verwendet, um auf ein WebSlate zu zeigen, wird eine Menüleiste mit einer integrierten Aktualisierungsschaltfläche und eine QuickInfo kurz erläutert, die den Einzelbenutzercharakter von WebSlates erläutert (einige Web-Apps bieten möglicherweise gemeinsame Erfahrungen). Dies bietet eine Möglichkeit, zur url zurückzukehren, die von Organisatoren festgelegt wurde, falls der Benutzer weg navigiert und verwendet werden kann, falls Web-Apps während eines Ereignisses Probleme haben. 

Hinzufügen eines steuerbaren Namens und einer Standard-URL

Hinweis: Wenn Sie bereits über ein WebSlateFramed-Prefab in einer vorhandenen Umgebung verfügen, aktualisieren Sie das Mesh-Toolkit auf Version 24.10 oder höher, um das Steuerelement zu erhalten. Danach können Sie mit Schritt 3 beginnen.

  1. Wählen Sie in der Hierarchie das webSlateFramed-Prefab aus, das Sie hinzugefügt haben.

    Screenshot der Liste des WebSlateFramed-Prefab in der Hierarchie hervorgehoben.

  2. Navigieren Sie im Inspektor zur WebSlate Controllable-Komponente , und fügen Sie dann im Feld "Anzeigename " einen Namen für die Steuerelementfunktion hinzu. Stellen Sie sicher, dass der Name einige Hinweise auf die Funktion des WebSlate in der Umgebung gibt; Dies wird von Organisatoren im Systemsteuerung gesehen und verwendet, um webSlate bei Bedarf in Echtzeit zu aktualisieren. In diesem Beispiel verwenden wir "Azure Dashboard".

    Screenshot der Liste des WebSlateFramed-Prefab in der Hierarchie hervorgehoben.

  3. Geben Sie in der Objektsteuerungskomponente einen Namen auf die gleiche Weise an.

  4. Erweitern Sie in der Hierarchie die WebSlateFramed-Komponente , und wählen Sie dann das untergeordnete Objekt " WebSlate" aus.

  5. Aktualisieren Sie im Inspektor das Feld "Aktuelle URL " auf die URL, die webSlate standardmäßig in einem Mesh-Ereignis laden soll.

    Screenshot des untergeordneten WebSlate-Objekts in der Hierarchie.

  6. Testen Sie webSlate im Wiedergabemodus, um sicherzustellen, dass die URL ordnungsgemäß angezeigt wird.

Weitere webSlate steuerbare Einstellungen

Screenshot der Liste der WebSlate Controllable-Komponente mit hervorgehobener Einstellung

Anhalten verhindern (WebSlate Controllable component): Diese Einstellung wird im Systemsteuerung angezeigt, und die Standardeinstellung ist deaktiviert. Dies bedeutet, dass das Webslate automatisch angehalten wird, wenn ein Teilnehmer sich von einem WebSlate entfernt und webSlate nicht mehr für 30 Sekunden oder länger in der Ansicht ist, wird das Webslate automatisch angehalten, um Arbeitsspeicher zu sparen. Es wird neu geladen, wenn das WebSlate erneut in die Ansicht des Teilnehmers eintritt.

In einigen Situationen müssen Inhalte möglicherweise für Teilnehmer wiedergegeben werden, unabhängig von ihrer Position im Ereignis (z. B. wenn webSlate Livestreaminhalte ausführt). In diesem Fall empfiehlt es sich, die Einstellung "Anhalten verhindern" zu aktivieren.

Der Ereignisorganisator kann diese Einstellung im Ereignis ein- und ausschalten. Wenn Sie die Standardeinstellung auf "Ein" ändern möchten, aktivieren Sie das Kontrollkästchen "Anhalten verhindern".

Backplate (WebSlate Controllable component): Die WebSlateFramed Prefab enthält das hier ausgewählte *Backplate GameObject, um den "Frame" bereitzustellen. Sie können dies in "Keine" ändern, um den Frame zu deaktivieren, es wird jedoch empfohlen, diese Einstellung beizubehalten, und sie bis zum Ereignisorganisator zu lassen, um die Backplate ein- oder auszuschalten.

Sichtbar (Objektsteuerungskomponente): Diese Einstellung wird auch im Systemsteuerung angezeigt, in dem der Ereignisorganier die Sichtbarkeit von WebSlates für alle Ereignisteilnehmer ein- oder ausschalten kann. Wählen Sie diese Option aus, wenn die Standardeinstellung "sichtbar" sein soll.

Hinweis: Wenn eine dieser Einstellungen während ereignissen geändert wird, werden die Änderungen in Echtzeit für alle Benutzer widergespiegelt.

Testen des Steuerelements in einem Gitterereignis

Das Testen der vollständig kontrollierten Funktionalität eines WebSlates kann nur in einem Mesh-Ereignis erfolgen. In unserem Beispielereignis basierend auf Ihrer Umgebung wird unser Beispiel "Controllable WebSlate", "Azure Dashboard", im Systemsteuerung angezeigt.

Screenshot der Systemsteuerung mit hervorgehobenem steuerelementierbaren Webslate.

Der Ereignisorganisator kann auf den nach unten weisenden Pfeil im Azure-Dashboard klicken, um die URL anzuzeigen, die sie dann ändern können.

Screenshot der Systemsteuerung mit hervorgehobener bearbeitbarer URL für webSlate.

Wie bereits erwähnt, kann der Organisator während des Ereignisses mehrere Einstellungen von WebSlate ändern, z . B. "Anhalten verhindern", "Backplate anzeigen" und "Sichtbar " (Ein-/Ausschalten).

Screenshot der Systemsteuerung mit verschiedenen Features für webSlate hervorgehoben.

WebSlate-Menü

Wenn jemand (Benutzer oder Organisatoren) eine WebSlate nähert und mit dem Cursor oder VR-Controller darauf zeigt, wird das WebSlate-Menü angezeigt.

Screenshot der Systemsteuerung mit verschiedenen Features für webSlate hervorgehoben.

Aktualisieren (linke Schaltfläche): Der Teilnehmer kann auf diese Schaltfläche klicken, um seine persönliche Ansicht wieder zur Standardwebseite für webSlate zurückzugeben.

Informationen (schaltfläche "Rechts"): Dadurch wird eine QuickInfo bereitgestellt, um den Teilnehmer daran zu erinnern, dass das, was sie sehen, für sie einzigartig ist und nicht für andere Teilnehmer freigegeben wird, es sei denn, webSlate zeigt eine Web-App für die Zusammenarbeit an.

Tipps

  • Sie können ein WebSlate auf einem anderen GameObjects als einem Quad platzieren, indem Sie WebSlate.cs als Skriptkomponente direkt zu Ihrem 3D-Objekt hinzufügen und UnlitWebSlate.mat zu MeshRenderer Materials hinzufügen. Beachten Sie, dass dies zu visueller Texturdehnung, Inversion und/oder Drehung führen kann.

  • Eine WebSlate lädt eine Standard-URL. Sie sollten diese URL durch eine url ersetzen, die Sie für jedes verwendete WebSlate bevorzugen. Der Helligkeitsparameter ist auf 1,0 festgelegt (100 % der Helligkeit des Browsers).

  • WebSlates werden automatisch angehalten, nachdem sie zu lang aus dem Bildschirm entfernt wurden. Wenn Sie sicherstellen müssen, dass ein bestimmtes WebSlate immer ausgeführt wird (z. B. ein Livestream oder eine kontinuierliche Audiowiedergabe), wählen Sie in der WebSlate-Komponente "Anhalten verhindern" aus. Beachten Sie, dass die Szene dazu führen kann, dass mehr Ressourcen verbraucht werden, da webSlate jederzeit aktiv bleibt.

  • Um die Bild-URL auf die Größe von WebSlate anzupassen, schließen Sie die URL in HTML um. Verwenden Sie die WebSlate LoadHTML-API durch visuelle Skripterstellung, um diesen HTML-Inhalt in WebSlate zu rendern. Fügen Sie der HTMLContent-Eigenschaft den erstellten HTML-Code hinzu. Alternativ können Sie die LoadHTMAsset-API verwenden und den HTML-Code als Ressource übergeben. Ersetzen Sie die Bild-URL durch Ihre Bild-URL.

    Beispiel-HTML mit bild-URL und visuellem Skriptingdiagramm mithilfe der LoadHTML- und LoadHTMLAsset-API:

    <!DOCTYPE html><html lang="en"><head><meta charset="UTF-8"><meta name="viewport" content="width=device-width initial-scale=1.0"><title>Microsoft</title></head><body style="margin: 0; height: 100vh; overflow: hidden; background-color: black;"><img src="https://learn.microsoft.com/en-us/mesh/media/webview-developer-guide/ArcadeWebSlate.png" loading="lazy" style="width: 100%; height: 100%;"></body></html>

    Screenshot, der zeigt, wie Visual Scripting für die Verwendung der LoadHTML-API eingerichtet wird.

    Screenshot, der zeigt, wie Visual Scripting für die Verwendung der LoadHTMLAsset-API eingerichtet wird.

Nächste Schritte