Verwenden des 3D-Viewers auf HoloLens (1st Generation)Using 3D Viewer on HoloLens (1st gen)

mit 3D-Viewer können Sie 3D-Modelle auf HoloLens (1st Gen) anzeigen.3D Viewer lets you view 3D models on HoloLens (1st gen). Sie können unterstützte FBX-Dateien von Microsoft Edge, OneDrive und anderen apps öffnen und anzeigen.You can open and view supported .fbx files from Microsoft Edge, OneDrive, and other apps.

Hinweis

Dieser Artikel bezieht sich auf die 3D-Viewer- App für immersive Einheit, die FBX-Dateien unterstützt und nur auf HoloLens (1st Gen) verfügbar ist.This article applies to the immersive Unity 3D Viewer app, which supports .fbx files and is only available on HoloLens (1st gen). Die vorinstallierte 3D-Viewer- App auf HoloLens 2 unterstützt das Öffnen von benutzerdefinierten 3D-3D-Modellen in der Mixed Reality-Startseite (siehe Übersicht über die Ressourcenanforderungen , um weitere Informationen zu erhalten.The pre-installed 3D Viewer app on HoloLens 2 supports opening custom .glb 3D models in the mixed reality home (see Asset requirements overview for more details.

Wenn Sie Probleme beim Öffnen eines 3D-Modells in 3D-Viewer haben oder bestimmte Features Ihres 3D-Modells nicht unterstützt werden, finden Sie Informationen unter unterstützte Inhalts Spezifikationen.If you're having trouble opening a 3D model in 3D Viewer, or certain features of your 3D model are unsupported, see Supported content specifications.

Informationen zum Erstellen oder Optimieren von 3D-Modellen zur Verwendung mit 3D-Viewer finden Sie unter Optimieren von 3D-Modellen für 3D-Viewer.To build or optimize 3D models for use with 3D Viewer, see Optimizing 3D models for 3D Viewer.

Es gibt zwei Möglichkeiten, ein 3D-Modell auf HoloLens zu öffnen.There are two ways to open a 3D model on HoloLens. Weitere Informationen finden Sie unter Anzeigen von FBX-Dateien auf HoloLens .See Viewing FBX files on HoloLens to learn more.

Wenn Sie nach dem Lesen dieser Themen Probleme haben, lesen Sie Problembehandlung.If you're having trouble after reading these topics, see Troubleshooting.

Unterstützte Inhalts SpezifikationenSupported content specifications

DateiformatFile format

  • FBX-FormatFBX format
  • Maximale FBX-Version 2015.1.0Maximum FBX release 2015.1.0

DateigrößeFile size

  • Mindestens 5 KBMinimum 5 KB
  • Maximal 500 MBMaximum 500 MB

GeometrieGeometry

  • Nur Polygonmodelle.Polygonal models only. Keine unter Teilungs Flächen oder NURBsNo subdivision surfaces or NURBs
  • Rechts händiges KoordinatensystemRight-handed coordinate system
  • Scherung in Transformationsmatrizen wird nicht unterstütztShear in transformation matrices is not supported

TexturenTextures

  • Textur-Maps müssen in die FBX-Datei eingebettet seinTexture maps must be embedded in the FBX file
  • Unterstützte BildformateSupported image formats
    • JPEG-und PNG-BilderJPEG and PNG images
    • BMP-Bilder (True-Color, 24-Bit-RGB)BMP images (24-bit RGB true-color)
    • TGA-Bilder (24-Bit-RGB und 32-Bit-RGBQ True-Color)TGA images (24-bit RGB and 32-bit RGBQ true-color)
  • Maximale Texturauflösung von 2048x2048Maximum texture resolution of 2048x2048
  • Maximal eine diffuse Karte, eine normale Karte und eine Spiegelungs-Würfel Karte pro MeshMaximum of one diffuse map, one normal map, and one reflection cube map per mesh
  • Alpha Kanal in diffusen Texturen bewirkt, dass Pixel verworfen werden, wenn unter 50%Alpha channel in diffuse textures causes pixels to be discarded if below 50%

AnimationAnimation

  • Skalieren/drehen/Übersetzen einer Animation für einzelne ObjekteScale/rotation/translation animation on individual objects
  • Skelett (manipulierte) Animation mit SkinningSkeletal (rigged) animation with skinning
    • Maximal 4 Einflüsse pro VertexMaximum of 4 influences per vertex

MaterialienMaterials

  • Unterstützte Lambert-und Phong-Materialien mit anpassbaren ParameternLambert and Phong materials are supported, with adjustable parameters
  • Unterstützte Materialeigenschaften für LambertSupported material properties for Lambert
    • Haupt Textur (RGB + Alpha Test)Main Texture (RGB + Alpha Test)
    • Diffuse Farbe (RGB)Diffuse Color (RGB)
    • Umgebungsfarbe (RGB)Ambient Color (RGB)
  • Unterstützte Materialeigenschaften für PhongSupported material properties for Phong
    • Haupt Textur (RGB + Alpha Test)Main Texture (RGB + Alpha Test)
    • Diffuse Farbe (RGB)Diffuse Color (RGB)
    • Umgebungsfarbe (RGB)Ambient Color (RGB)
    • Glanzfarbe (RGB)Specular Color (RGB)
    • GlanzShininess
    • ReflektivitätReflectivity
  • Benutzerdefinierte Materialien werden nicht unterstützt.Custom materials are not supported
  • Maximal ein Material pro MeshMaximum of one material per mesh
  • Maximal eine MaterialschichtMaximum of one material layer
  • Maximal 8 Materialien pro DateiMaximum of 8 materials per file

Datei-und Modell EinschränkungenFile and model limitations

Die Größe von Dateien sowie die Anzahl von Modellen, Scheitelpunkten und Gittern, die gleichzeitig in 3D-Viewer geöffnet werden können, sind hart begrenzt:There are hard limits on the size of files, as well as the number of models, vertices, and meshes that can be open simultaneously in 3D Viewer:

  • 500 MB maximale Dateigröße pro Modell500 MB maximum file size per model
  • Eckpunkte: 600.000 kombiniert auf allen geöffneten ModellenVertices: 600,000 combined on all open models
  • Gitter: 1.600 kombiniert auf allen geöffneten ModellenMeshes: 1,600 combined on all open models
  • Maximale Anzahl von 40-Modellen, die gleichzeitig geöffnet sindMaximum of 40 models open at one time

Optimieren von 3D-Modellen für 3D-ViewerOptimizing 3D models for 3D Viewer

Besondere ÜberlegungenSpecial considerations

  • Vermeiden Sie schwarze Materialien oder schwarze Bereiche in Textur-Maps.Avoid black materials or black areas in texture maps. Hologramme werden aus Licht hergestellt, wodurch HoloLens schwarz (das Fehlen von Licht) als transparent rendert.Holograms are made of light, thus HoloLens renders black (the absence of light) as transparent.
  • Bevor Sie aus Ihrem Erstellungstool in FBX exportieren, stellen Sie sicher, dass alle Geometrien sichtbar und entriegelt sind und keine Layer, die Geometrie enthalten, deaktiviert oder mit einer Vorlage erstellt werden.Before exporting to FBX from your creation tool, ensure all geometry is visible and unlocked and no layers that contain geometry are turned off or templated. Die Sichtbarkeit wird nicht berücksichtigt.Visibility is not respected.
  • Vermeiden Sie sehr große Verschiebungs Verschiebungen zwischen Knoten (beispielsweise 100.000-Einheiten).Avoid very large translation offsets between nodes (for example, 100,000 units). Dies kann dazu führen, dass das Modell wackelt, während es verschoben/skaliert/gedreht wird.This can cause the model to jitter while being moved/scaled/rotated.

LeistungsoptimierungPerformance optimization

Berücksichtigen Sie die Leistung beim Erstellen von Inhalten und überprüfen in der 3D-Viewer-App auf HoloLens während des Erstellungsprozesses, um optimale Ergebnisse zu erzielen.Keep performance in mind while authoring content and validate in the 3D Viewer app on HoloLens during the authoring process for best results. 3D-Viewer rendert Inhalte in Echtzeit und die Leistung unterliegt den HoloLens-Hardwarefunktionen.3D Viewer renders content real-time and performance is subject to HoloLens hardware capabilities.

In einem 3D-Modell gibt es viele Variablen, die sich auf die Leistung auswirken können.There are many variables in a 3D model that can impact performance. der 3D-Viewer zeigt eine Warnung beim Laden an, wenn mehr als 150.000 Scheitelpunkte oder mehr als 400 Netze vorhanden sind.3D Viewer will show a warning on load if there are more than 150,000 vertices or more than 400 meshes. Animationen können Auswirkungen auf die Leistung anderer offener Modelle haben.Animations can have an impact on the performance of other open models. Es gibt auch harte Grenzwerte für die Gesamtzahl Modelle, Scheitelpunkte und Gitter, die gleichzeitig in 3D-Viewer geöffnet werden können (siehe Datei-und Modell Einschränkungen).There are also hard limits on the total number models, vertices, and meshes that can be open simultaneously in 3D Viewer (see File and model limitations).

Wenn das 3D-Modell aufgrund der Modellkomplexität nicht gut läuft, sollten Sie Folgendes berücksichtigen:If the 3D model isn't running well due to model complexity, consider:

  • Reduzieren der PolygonanzahlReducing polygon count
  • Verringern der Anzahl von Bones in manipulierten AnimationenReducing number of bones in rigged animation
  • Selbst Okklusion vermeidenAvoiding self-occlusion

Das doppelseitige Rendering wird in 3D-Viewer unterstützt, obwohl es aus Leistungsgründen standardmäßig deaktiviert ist.Double-sided rendering is supported in 3D Viewer, although it is turned off by default for performance reasons. Diese Option kann über die doppelseitige Schaltfläche auf der Detail Seite aktiviert werden.This can be turned on via the Double Sided button on the Details page. Um eine optimale Leistung zu erzielen, sollten Sie den Inhalt nicht doppelseitig rendern.For best performance, avoid the need for double-sided rendering in your content.

Überprüfen Ihres 3D-ModellsValidating your 3D model

Überprüfen Sie Ihr Modell, indem Sie es in 3D-Viewer auf HoloLens öffnen.Validate your model by opening it in 3D Viewer on HoloLens. Wählen Sie die Schaltfläche " Details " aus, um die Eigenschaften und Warnungen des Modells für nicht unterstützte Inhalte anzuzeigen (sofern vorhanden).Select the Details button to view your model's characteristics and warnings of unsupported content (if present).

Rendern von 3D-Modellen mit lebensechten DimensionenRendering 3D models with true-to-life dimensions

Standardmäßig zeigt 3D-Viewer 3D-Modelle mit einer bequemen Größe und Position relativ zum Benutzer an.By default, 3D Viewer displays 3D models at a comfortable size and position relative to the user. Wenn Sie jedoch ein 3D-Modell mit true-to-Life-Messungen rendern möchten (beispielsweise beim Auswerten von Möbeln in einem Raum), kann der Inhaltsersteller innerhalb der Datei Metadaten eine Kennzeichnung festlegen, um zu verhindern, dass die Größe des Modells sowohl von der Anwendung als auch vom Benutzer geändert wird.However, if rendering a 3D model with true-to-life measurements is important (for example, when evaluating furniture models in a room), the content creator can set a flag within the file's metadata to prevent resizing of that model by both the application and the user.

Wenn Sie das Skalieren des Modells verhindern möchten, fügen Sie einem beliebigen Objekt in der Szene mit dem Namen Microsoft_DisableScale ein boolesches benutzerdefiniertes Attribut hinzu, und setzen Sie es auf true.To prevent scaling of the model, add a Boolean custom attribute to any object in the scene named Microsoft_DisableScale and set it to true. der 3D-Betrachter respektiert dann die FbxSystemUnit-Informationen, die in die FBX-Datei eingebrannt sind.3D Viewer will then respect the FbxSystemUnit information baked into the FBX file. Die Skalierung im 3D-Viewer beträgt 1 Meter pro FBX-Einheit.Scale in 3D Viewer is 1 meter per FBX unit.

Anzeigen von FBX-Dateien auf HoloLensViewing FBX files on HoloLens

Öffnen einer FBX-Datei von Microsoft EdgeOpen an FBX file from Microsoft Edge

FBX-Dateien können direkt von einer Website mit Microsoft Edge auf HoloLens geöffnet werden.FBX files can be opened directly from a website using Microsoft Edge on HoloLens.

  1. Navigieren Sie in Microsoft Edge zu der Webseite, die die FBX-Datei enthält, die Sie anzeigen möchten.In Microsoft Edge, navigate to the webpage containing the FBX file you want to view.
  2. Wählen Sie die Datei aus, um sie herunterzuladen.Select the file to download it.
  3. Wenn der Download abgeschlossen ist, wählen Sie die Schaltfläche Öffnen in Microsoft Edge aus, um die Datei in 3D-Viewer zu öffnen.When the download is complete, select the Open button in Microsoft Edge to open the file in 3D Viewer.

Auf die heruntergeladene Datei kann später mithilfe von Downloads in Microsoft Edge zugegriffen und dann erneut geöffnet werden.The downloaded file can be accessed and opened again later by using Downloads in Microsoft Edge. Wenn Sie ein 3D-Modell speichern und den fortgesetzten Zugriff sicherstellen möchten, laden Sie die Datei auf Ihren PC herunter, und speichern Sie Sie auf Ihrem OneDrive-Konto.To save a 3D model and ensure continued access, download the file on your PC and save it to your OneDrive account. Die Datei kann dann über die OneDrive-App auf HoloLens geöffnet werden.The file can then be opened from the OneDrive app on HoloLens.

Hinweis

Einige Websites mit herunterladbaren FBX-Modellen bieten diese im komprimierten ZIP-Format.Some websites with downloadable FBX models provide them in compressed ZIP format. der 3D-Viewer kann ZIP-Dateien nicht direkt öffnen.3D Viewer cannot open ZIP files directly. Verwenden Sie stattdessen Ihren PC, um die FBX-Datei zu extrahieren und auf Ihrem OneDrive-Konto zu speichern.Instead, use your PC to extract the FBX file and save it to your OneDrive account. Die Datei kann dann über die OneDrive-App auf HoloLens geöffnet werden.The file can then be opened from the OneDrive app on HoloLens.

Öffnen einer FBX-Datei von OneDriveOpen an FBX file from OneDrive

FBX-Dateien können über OneDrive mit der OneDrive-App auf HoloLens geöffnet werden.FBX files can be opened from OneDrive by using the OneDrive app on HoloLens. Stellen Sie sicher, dass Sie OneDrive mit der Microsoft Store-App auf HoloLens installiert haben und dass Sie die FBX-Datei bereits auf OneDrive auf Ihrem PC hochgeladen haben.Be sure you've installed OneDrive using Microsoft Store app on HoloLens and that you've already uploaded the FBX file to OneDrive on your PC.

In OneDrive können FBX-Dateien auf eine von zwei Arten auf HoloLens mit 3D-Viewer geöffnet werden:Once in OneDrive, FBX files can be opened on HoloLens using 3D Viewer in one of two ways:

  • Starten Sie OneDrive auf HoloLens, und wählen Sie die FBX-Datei aus, um Sie in 3D-Viewer zu öffnen.Launch OneDrive on HoloLens and select the FBX file to open it in 3D Viewer.
  • Starten Sie den 3D-Viewer, tippen Sie auf, um die Symbolleiste anzuzeigen, und wählen Sie Datei öffnenaus.Launch 3D Viewer, air tap to show the toolbar, and select Open File. OneDrive wird gestartet, sodass Sie eine FBX-Datei auswählen können.OneDrive will launch, allowing you to select an FBX file.

ProblembehandlungTroubleshooting

Beim Öffnen eines 3D-Modells wird eine Warnung angezeigtI see a warning when I open a 3D model

Eine Warnung wird angezeigt, wenn Sie versuchen, ein 3D-Modell zu öffnen, das Features enthält, die von 3D Viewer nicht unterstützt werden, oder wenn das Modell zu komplex ist und die Leistung beeinträchtigt werden kann.You will see a warning if you attempt to open a 3D model that contains features that are not supported by 3D Viewer, or if the model is too complex and performance may be affected. in 3D-Viewer wird weiterhin das 3D-Modell geladen, aber die Leistung oder visuelle Genauigkeit kann beeinträchtigt werden.3D Viewer will still load the 3D model, but performance or visual fidelity may be compromised.

Weitere Informationen finden Sie unter unterstützte Inhalts Spezifikationen und Optimieren von 3D-Modellen für 3D-Viewer.For more info, see Supported content specifications and Optimizing 3D models for 3D Viewer.

Eine Warnung wird angezeigt, und das 3D-Modell wird nicht geladenI see a warning and the 3D model doesn't load

Eine Fehlermeldung wird angezeigt, wenn 3D-Viewer aufgrund der Komplexität oder Dateigröße kein 3D-Modell laden kann oder wenn die FBX-Datei beschädigt oder ungültig ist.You will see an error message when 3D Viewer cannot load a 3D model due to complexity or file size, or if the FBX file is corrupt or invalid. Außerdem wird eine Fehlermeldung angezeigt, wenn Sie die maximale Anzahl von Modellen, Scheitelpunkten oder Gittern erreicht haben, die gleichzeitig geöffnet sein können.You will also see an error message if you have reached the limit on the total number of models, vertices, or meshes that can be open simultaneously.

Weitere Informationen finden Sie unter unterstützte Inhalts Spezifikationen sowie Datei-und Modell Einschränkungen.For more info, see Supported content specifications and File and model limitations.

Wenn Sie der Meinung sind, dass Ihr Modell die unterstützten Inhalts Spezifikationen erfüllt und die Datei-oder Modell Einschränkungen nicht überschritten hat, können Sie Ihre FBX-Datei an das 3D-Viewer-Team unter holoapps@Microsoft.com senden.If you feel your model meets the supported content specifications and has not exceeded the file or model limitations, you may send your FBX file to the 3D Viewer team at holoapps@microsoft.com. Wir sind nicht in der Lage, persönlich zu antworten, aber mit Beispielen für Dateien, die nicht ordnungsgemäß geladen werden, können wir unser Team bei zukünftigen Versionen der APP verbessern.We are not able to respond personally, but having examples of files that do not load properly will help our team improve on future versions of the app.

Mein 3D-Modell wird geladen, wird aber nicht wie erwartet angezeigtMy 3D model loads, but does not appear as expected

Wenn Ihr 3D-Modell in 3D-Viewer nicht wie erwartet aussieht, tippen Sie auf, um die Symbolleiste anzuzeigen, und wählen Sie dann Detailsaus.If your 3D model does not look as expected in 3D Viewer, air tap to show the toolbar, then select Details. Aspekte der Datei, die vom 3D-Viewer nicht unterstützt werden, werden als Warnungen hervorgehoben.Aspects of the file which are not supported by 3D Viewer will be highlighted as warnings.

Das häufigste Problem, das möglicherweise angezeigt wird, ist das Fehlen von Texturen, wahrscheinlich, weil Sie nicht in die FBX-Datei eingebettet sind.The most common issue you might see is missing textures, likely because they are not embedded in the FBX file. In diesem Fall wird das Modell weiß angezeigt.In this case, the model will appear white. Dieses Problem kann beim Erstellungsprozess behoben werden, indem Sie aus Ihrem Erstellungstool nach FBX exportieren, wobei die Option Texturen einbetten ausgewählt ist.This issue can be addressed in the creation process by exporting from your creation tool to FBX with the embed textures option selected.

Weitere Informationen finden Sie unter unterstützte Inhalts Spezifikationen und Optimieren von 3D-Modellen für 3D-Viewer.For more info, see Supported content specifications and Optimizing 3D models for 3D Viewer.

Bei der Anzeige meines 3D-Modells fällt die Leistung abI experience performance drops while viewing my 3D model

Die Leistung beim Laden und Anzeigen eines 3D-Modells kann von der Komplexität des Modells, der Anzahl der gleichzeitig geöffneten Modelle oder der Anzahl von Modellen mit aktiven Animationen beeinflusst werden.Performance when loading and viewing a 3D model can be affected by the complexity of the model, number of models open simultaneously, or number of models with active animations.

Weitere Informationen finden Sie unter Optimieren von 3D-Modellen für 3D-Viewer sowie Datei-und Modell Einschränkungen.For more info, see Optimizing 3D models for 3D Viewer and File and model limitations.

Wenn ich eine FBX-Datei auf HoloLens öffne, wird Sie nicht in 3D-Viewer geöffnet.When I open an FBX file on HoloLens, it doesn't open in 3D Viewer

3D-Viewer wird automatisch der Dateierweiterung FBX zugeordnet, wenn Sie installiert ist.3D Viewer is automatically associated with the .fbx file extension when it is installed.

Wenn Sie versuchen, eine FBX-Datei zu öffnen und ein Dialogfeld anzuzeigen, das Sie an den Microsoft Store weiterleitet, verfügen Sie zurzeit nicht über eine APP, die mit der FBX-Dateierweiterung auf HoloLens verknüpft ist.If you try to open an FBX file and see a dialog box that directs you to Microsoft Store, you do not currently have an app associated with the .fbx file extension on HoloLens.

Überprüfen Sie, ob 3D Viewer installiert ist.Verify that 3D Viewer is installed. Wenn es nicht installiert ist, laden Sie es aus dem Microsoft Store auf HoloLens.If it is not installed, download it from Microsoft Store on HoloLens.

Wenn 3D Viewer bereits installiert ist, starten Sie den 3D-Viewer, und versuchen Sie dann erneut, die Datei zu öffnen.If 3D Viewer is already installed, launch 3D Viewer, then try opening the file again. Wenn das Problem weiterhin besteht, deinstallieren Sie 3D Viewer, und installieren Sie es erneut.If the issue persists, uninstall and reinstall 3D Viewer. Dadurch wird die Dateierweiterung FBX erneut mit 3D-Viewer verknüpft.This will re-associate the .fbx file extension with 3D Viewer.

Wenn beim Versuch, eine FBX-Datei zu öffnen, eine andere App als 3D-Viewer geöffnet wird, wurde diese APP wahrscheinlich nach 3D-Viewer installiert und hat die Zuordnung zur Dateierweiterung FBX übernommen.If attempting to open an FBX file opens an app other than 3D Viewer, that app was likely installed after 3D Viewer and has taken over association with the .fbx file extension. Wenn Sie möchten, dass der 3D-Viewer der Dateierweiterung FBX zugeordnet wird, deinstallieren Sie den 3D-Viewer, und installieren Sie ihn erneut.If you prefer 3D Viewer to be associated with the .fbx file extension, uninstall and reinstall 3D Viewer.

Die Schaltfläche "Datei öffnen" im 3D-Viewer startet keine appThe Open File button in 3D Viewer doesn't launch an app

Mit der Schaltfläche Datei öffnen wird die APP geöffnet, die der Dateiauswahl Funktion auf HoloLens zugeordnet ist.The Open File button will open the app associated with the file picker function on HoloLens. Wenn OneDrive installiert ist, sollte die Schaltfläche Datei öffnen OneDrive starten.If OneDrive is installed, the Open File button should launch OneDrive. Wenn jedoch derzeit keine app mit der auf HoloLens installierten Dateiauswahl Funktion verknüpft ist, werden Sie zum Microsoft Store weitergeleitet.However, if there is currently no app associated with the file picker function installed on HoloLens, you will be directed to Microsoft Store.

Wenn die Schaltfläche Datei öffnen eine andere App als OneDrive startet, wurde diese APP wahrscheinlich nach OneDrive installiert und hat die Zuordnung zur Dateiauswahl Funktion übernommen.If the Open File button launches an app other than OneDrive, that app was likely installed after OneDrive and has taken over association with the file picker function. Wenn Sie möchten, dass OneDrive beim Auswählen der Schaltfläche Datei öffnen in 3D-Viewer gestartet wird, deinstallieren und installieren Sie OneDrive.If you prefer OneDrive to launch when selecting the Open File button in 3D Viewer, uninstall and reinstall OneDrive.

Wenn die Schaltfläche Datei öffnen nicht aktiviert ist, ist es möglich, dass Sie die Obergrenze von Modellen erreicht haben, die gleichzeitig in 3D-Viewer geöffnet sein können.If the Open File button is not active, it's possible that you have reached the limit of models that can be open in 3D Viewer at one time. Wenn Sie 40-Modelle in 3D-Viewer geöffnet haben, müssen Sie einige schließen, bevor Sie weitere Modelle öffnen können.If you have 40 models open in 3D Viewer, you will need to close some before you will be able to open additional models.

Zusätzliche RessourcenAdditional resources