Freigeben über

Integrieren eines Modells in Ihre App mit Windows ML

In diesem Handbuch wird erläutert, wie Sie die Windows ML-APIs verwenden, um ein Modell in Ihre Windows-App zu integrieren. Wenn Sie auch den automatischen Codegenerator von Windows ML verwenden möchten, schauen Sie sich mlgen an.

Wichtige APIs: Windows.AI.MachineLearning

Wir werden die grundlegenden Bausteine von Windows ML durchgehen, die:

  • Modelle
  • Sitzungen
  • Geräte
  • Bindungen

Sie verwenden diese, um Ihre Modelle mit Windows ML zu laden, zu binden und auszuwerten.

Außerdem empfehlen wir, sich unsere Beispiel-Apps auf GitHub anzusehen, um End-to-End-Windows ML-Codebeispiele anzuzeigen.

Das folgende Video zeigt diese APIs in Aktion in einer kurzen Demo.


Verwenden von WinML-APIs in C++

Während die WinML-APIs sowohl in C++/CX als auch in C++/WinRT verfügbar sind, empfehlen wir die Verwendung der C++/WinRT-Version, da sie natürlichere C++-Codierungen ermöglicht und wo die meisten Entwicklungsbemühungen in Zukunft fokussiert werden. Sie können die nachstehenden Anweisungen befolgen, die sich auf Ihre spezielle Situation beziehen, um die C++/WinRT-APIs zu verwenden:

  • Wenn Sie auf Windows 1803 oder früher abzielen, lesen Sie Tutorial: Portieren einer vorhandenen WinML-App zu NuGet-Paket.
  • Wenn Sie eine neue C++-Anwendung erstellen, lesen Sie das Lernprogramm: Erstellen einer Windows Machine Learning Desktop-Anwendung (C++) und führen Sie die Schritte zum Laden des Modells aus.
  • Wenn Sie über eine vorhandene C++-Anwendung verfügen (die noch nicht für C++/WinRT eingerichtet ist), führen Sie die folgenden Schritte aus, um Ihre Anwendung für C++/WinRT einzurichten:
    1. Stellen Sie sicher, dass die neueste Version von Visual Studio 2019 installiert ist (jede Edition).
    2. Stellen Sie sicher, dass Sie über das SDK für Windows 10, Version 1803 oder höher, verfügen.
    3. Laden Sie die C++/WinRT Visual Studio-Erweiterung (VSIX) aus dem Visual Studio Marketplace herunter, und installieren Sie sie.
    4. Fügen Sie die <CppWinRTEnabled>true</CppWinRTEnabled> Eigenschaft zur .vcxproj Datei des Projekts hinzu: 
      <Project ...>
    <PropertyGroup Label="Globals">
        <CppWinRTEnabled>true</CppWinRTEnabled>
...
    5. C++/WinRT erfordert Features aus dem C++17-Standard. Legen Sie daher in den Projekteigenschaften C/C++ > Sprache > C++-Sprachstandard > ISO-C++17-Standard (/std:c++17) fest.
    6. Legen Sie den Konformitätsmodus fest: Ja (/permissiv-) in Ihren Projekteigenschaften.
    7. Eine weitere Projekteigenschaft, die Sie beachten müssen, ist C/C++ > : Allgemeine > Warnungen als Fehler behandeln. Legen Sie dies auf Ja (/WX) oder Nein (/WX-) fest, um es zu probieren. Manchmal generieren Quelldateien, die vom cppwinrt.exe Tool generiert werden, Warnungen, bis Sie ihre Implementierung hinzufügen.
    8. Das VSIX bietet Ihnen außerdem die native Debug-Visualisierung (natvis) von projizierten C++/WinRT-Typen in Visual Studio, die eine ähnliche Erfahrung wie das C#-Debuggen bietet. Natvis ist automatisch für Debug-Builds. Sie können die Release-Builds aktivieren, indem Sie das Symbol WINRT_NATVIS definieren.
    9. Ihr Projekt sollte jetzt für C++/WinRT eingerichtet werden. Weitere Informationen finden Sie unter C++/WinRT .

Hinweis

Verwenden Sie die folgenden Ressourcen, wenn Sie Hilfe mit Windows ML benötigen:

  • Wenn Sie technische Fragen zu Windows ML stellen oder beantworten möchten, verwenden Sie das Tag windows-machine-learning auf Stack Overflow.
  • Um einen Fehler zu melden, erstellen Sie bitte eine Meldung auf unserem GitHub.
  • Last updated on