Versionshinweise zu Windows App SDK 2.0

Das neue experimentelle SplitMenuFlyoutItem-Steuerelement wurde entwickelt, um eine geteilte Schaltfläche in einem Menü-Flyout bereitzustellen. Mit diesem Steuerelement können Entwickler eine primäre Standardaktion verfügbar machen und gleichzeitig zusätzliche Optionen über ein Untermenü anbieten, ideal für die Verdichtung komplexer Funktionen in einen kleineren Speicherbedarf und zum Speichern der Gesamtmenülänge.

Zusammen mit den Funktionen von MenuFlyoutItem und MenuFlyoutSubItem verfügt das Steuerelement über zwei andere Eigenschaften: SubMenuPresenterStyle und SubMenuItemStyleermöglicht die Anpassung des Untermenüs, z. B. die Verwendung von GridView für den Untermenüreferent.

    <Button Content="Open file">
        <Button.Flyout>
            <MenuFlyout>
                <SplitMenuFlyoutItem Text="Open with Notepad">
                    <MenuFlyoutItem Text="Visual Studio" />
                    <MenuFlyoutItem Text="VS Code" />
                    <MenuFlyoutItem Text="Word" />
                </SplitMenuFlyoutItem>
            </MenuFlyout>
        </Button.Flyout>
    </Button>

Umbenannte Typen

• Umbenannt WinMLCatalogModel in ModelCatalog
• Umbenannt CatalogModelSource in ModelCatalogSource

Methodenaktualisierungen

• CatalogModelInfo: Umbenannt GetInstance in GetInstanceAsync
• ModelCatalogSource: Umbenannt CreateFromUri in CreateFromUriAsync
• ModelCatalog: Umbenannt FindModel in FindModelAsync
• ModelCatalog: Umbenannt FindAllModels in FindAllModelsAsync

Eigenschaftsänderungen

• Aktualisiert CatalogModelInfo.Size auf CatalogModelInfo.ModelSizeInBytes

Verhaltensupdates

• Instanz aus CatalogModelInstanceResult abrufen mit .GetInstance()
• CatalogModelStatus gibt "Bereit" oder "NichtBereit" basierend auf der lokalen Verfügbarkeit zurück.
• Hinzugefügt CatalogModelInstanceStatus , um den Instanzstatus vom Modellstatus zu trennen

CatalogModelInfo-Verbesserungen

• Umbenannt Alias in Name
• Umbenannt Revision in Version
• Publisher hinzugefügt
• DisplayName entfernt

JSON-Änderungen

• Wurde in aliasumbenanntid.
• Entfernt modelType und description.
• Wurde in executionProviderumbenanntexecutionProviders.
• Aktualisiert executionProviders , um ein Array von JSON-Objekten anstelle einer durch Trennzeichen getrennten Liste zu sein.

Weitere Änderungen

• ModelCatalog gibt jetzt eine Liste der Ausführungsanbieter (EPs) zurück, wenn eine Instanz erstellt wird.
• Unterstützung für Windows 10 (1809) und höher hinzugefügt.
• Unterstützung für lokale Dateien hinzugefügt, einschließlich regulärer Dateien und MSIX-Pakete.
• Abstürze, die durch einen ungültigen JSON-Katalog verursacht wurden, wurden behoben.

• Der vorherige AppIndexQuery-Typ, der die GetNextTextMatches und GetNextImageMatches-Methoden enthielt, wurde in zwei verschiedene Typen aufgeteilt: AppIndexTextQuery und AppIndexImageQuery. Die AppContentIndexer.CreateQuery Methode wurde ersetzt durch: CreateTextQuery und CreateImageQuery.

• Diese Methoden geben nun AppIndexTextQuery bzw. AppIndexImageQuery zurück. Um die Verwendung zu vereinfachen, wurden auch die Optionentypen aktualisiert:

  • Entfernt: AppIndexQueryOptions, TextMatchOptions und ImageMatchOptions
  • Hinzugefügt: TextQueryOptions und ImageQueryOptions

• Die APIs im AppContentIndex-Namespace, die zuvor Arrays zurückgegeben haben, geben jetzt IVectorView für eine verbesserte Konsistenz und Leistung zurück.

• Die AppContentIndexer.WaitForIndexingIdleAsync Methode wurde aktualisiert, um einen TimeSpan Parameter anstelle einer ganzen Zahl zu akzeptieren, wodurch eine klarere und flexiblere Timeoutbehandlung bereitgestellt wird.

Die VideoScaler API bietet eine Verbesserung von Echtzeitvideos durch erweitertes KI-Upscaling, das für Streams optimiert ist, die Personen in Unterhaltungen zeigen. Es ermöglicht Entwicklern, schärfere, klarere visuelle Elemente über Konferenz-, Streaming- und Bearbeitungsplattformen hinweg bereitzustellen, auch unter schlechten Netzwerkbedingungen. Die API unterstützt die Anpassung von Ausgabeauflösung, Bildfrequenz und interessanten Regionen mit Kompatibilität für mehrere Videoformate, einschließlich BGR, RGB und NV12.

Mit der neuen RewriteCustomAsync-API können Sie eine Eingabezeichenfolge bereitstellen, die Phi Silica beim Umschreiben von ausgewähltem Text leitet. Sie können mit neuen kreativen Stilen wie "Goofy" oder "Pirate" experimentieren, um Ihre Inhalte sofort zu transformieren.

Die ImageGenerator Klasse nutzt stabile Diffusionsmodelle, um leistungsstarke Bildgenerierungsfunktionen bereitzustellen. Es unterstützt Szenarien mit mehreren Generationen:

• Text-zu-Bild: Generieren Sie Bilder aus beschreibenden Textaufforderungen.

• Bild-zu-Bild: Transformieren Sie vorhandene Bilder basierend auf Textbeschreibungen.

• Magische Füllung: Füllen Sie maskierte Bereiche von Bildern mit KI-generierten Inhalten.

• Farbbuchformat: Generieren Sie Bilder im Farbbuchstil.

• Neu entwerfen: Ändern Sie den künstlerischen Stil vorhandener Bilder, während Sie die Struktur beibehalten.

Alle generierten Bilder werden im RGB8-Format über ImageBuffer-Objekte zurückgegeben. Die API enthält integrierte Inhaltssicherheitsfilter und unterstützt anpassbare Generierungsparameter.

using Microsoft.Windows.AI.Imaging;
using Microsoft.Graphics.Imaging;
 
public async Task GenerateImageFromText()
{
    var readyState = ImageGenerator.GetReadyState();
    if (readyState != AIFeatureReadyState.Ready)
    {
        var progress = new Progress<double>(p => Console.WriteLine($"Download progress: {p:P}"));
        var result = await ImageGenerator.EnsureReadyAsync();
        if (result.Status != AIFeatureReadyResultState.Success)
        {
            Console.WriteLine("Failed to prepare models");
            return;
        }
    }
 
    using var generator = await ImageGenerator.CreateAsync();
 
    var options = new ImageGenerationOptions
    {
        MaxInferenceSteps = 6,
        Creativity = 0.8,
        Seed = 42
    };
 
    var result = generator.GenerateImageFromTextPrompt("A beautiful sunset over a mountain lake", options);
 
    if (result.Status == ImageGeneratorResultStatus.Success)
    {
        await SaveImageBufferAsync(result.Image, "generated_image.png");
    }
}

Diese Version enthält die folgenden neuen und modifizierten experimentellen APIs im Vergleich zu 2.0-experimental2:

Microsoft.Graphics.Imaging

    ImageBufferPixelFormat
        Bgr8

Microsoft.UI.Xaml.Automation.Peers

    SplitMenuFlyoutItemAutomationPeer

Microsoft.UI.Xaml.Controls

    SplitMenuFlyoutItem

Microsoft.Windows.AI.Imaging

    ImageFromImageGenerationOptions
    ImageFromImageGenerationStyle
    ImageFromTextGenerationOptions
    ImageFromTextGenerationStyle
    ImageGenerationOptions
    ImageGenerator
    ImageGeneratorContract
    ImageGeneratorResult
    ImageGeneratorResultStatus
    TextRecognizer
        RecognizeTextFromImage
        RecognizeTextFromImageAsync

    TextRecognizerOptions

Microsoft.Windows.AI.MachineLearning

    CatalogModelInfo
    CatalogModelInstance
    CatalogModelInstanceResult
    CatalogModelInstanceStatus
    CatalogModelStatus
    ModelCatalog
    ModelCatalogSource

Microsoft.Windows.AI.Search.Experimental.AppContentIndex

    AppContentIndexer
        CreateImageQuery
        CreateTextQuery
        WaitForIndexingIdleAsync

    AppIndexImageQuery
    AppIndexTextQuery
    ImageQueryOptions
    TextQueryOptions

Microsoft.Windows.AI.Text

    TextRewriter
        RewriteCustomAsync

Microsoft.Windows.AI.Video

    ScaleFrameStatus
    VideoScaler
    VideoScalerOptions
    VideoScalerResult

• Korrektur der Berechnung des Begrenzungsrahmens bei gedrehtem Text. Unter bestimmten Umständen meldete der OCR-Textabgleich innerhalb von Bildern ungenaue oder leere Bereiche, wenn der Text gedreht wurde.

Die AppContentIndexer-APIs ermöglichen Entwicklern die effiziente Indizierung von App-Inhalten, einschließlich Text und Bildern für einen schnellen und relevanten Abruf. Diese APIs unterstützen sowohl lexikalische (schlüsselwortbasierte) als auch semantische (bedeutungsbasierte) Suchanfragen und ermöglichen Apps, schnelle und relevante Ergebnisse basierend auf Benutzerabsicht und Kontext zu liefern, anstatt nur auf genaue Schlüsselwörter.

Diese Funktion entsperrt die folgenden erweiterten Szenarien:

• Semantische Suche
  Apps können Ergebnisse basierend auf Absicht und Bedeutung und nicht auf exakten Schlüsselwortabgleichen zurückgeben.
  Beispiel: Eine Abfrage für "Projektzeitachse" kann Inhalte anzeigen, die "Terminplan" oder "Liefertermine" erwähnen, auch wenn diese genauen Wörter nicht verwendet wurden.
• Retrieval-Augmented Generation (RAG)
  Indizierte Inhalte können als Wissensbasis für generative KI-Modelle dienen. Wenn ein Benutzer eine Frage stellt, ruft die App die relevantesten Dokumente oder Codeausschnitte aus seinem Index ab und leitet sie in das Modell ein, wodurch präzise, kontextbezogene Antworten ermöglicht werden, die in realen Daten geerdet sind.

Die Windows ML-Modellkatalog-APIs ermöglichen Es Ihrer App oder Bibliothek, große KI-Modelldateien dynamisch aus Ihren eigenen Onlinemodellkatalogen zu ermitteln und herunterzuladen, sodass diese großen Dateien nicht direkt mit Ihrer App oder Bibliothek verpackt werden müssen. Der Modellkatalog trägt dazu bei, die Gerätekompatibilität zu gewährleisten, indem Modelle gefiltert und nur diejenigen heruntergeladen werden, die für das jeweilige Verwendete Windows-Gerät gelten.

Das neueste Microsoft.Windows.Storage.Pickers Update optimiert die Datei- und Ordnerauswahl, indem Entwickler initiale und persistente Ordnerspeicherorte festlegen und Dateitypfilter mit eindeutigen Bezeichnungen gruppieren können, um die Navigation zu vereinfachen.

Die PopupAnchor API ermöglicht DesktopPopupSiteBridge jetzt die relative Positionierung durch Verankerung an das eigene Fenster oder die Insel, wobei die Einschränkung behoben wird, dass Popups nur absolut mithilfe von Bildschirmkoordinaten positioniert werden konnten.

Mit der InputUnderlyingWindowController API können Entwickler den Ziel-HWND für den Empfang von Eingabemeldungen festlegen, die ursprünglich an ein ContentIsland gesendet wurden, das von einem SystemVisual erstellt wurde (siehe ContentIsland.CreateForSystemVisual).

SystemBackdropHost ermöglicht das Platzieren eines Systemhintergrunds (Acryl/Glimmer) an einer beliebigen Stelle innerhalb der visuellen Struktur einer Anwendung.

Dies WrapPanel ist ein WinUI-XAML-Layoutpanel, das untergeordnete Elemente in einer sequentiellen Reihenfolge von links nach rechts anordnet. Elemente, die die Zeile überlaufen, werden am Ende des Panels automatisch in die nächste Zeile umgebrochen. Es ist nützlich für reaktionsfähige Layouts.

Dies ist ein Port des vorhandenen Windows Community Toolkit-Steuerelements.

Diese Version enthält die folgenden neuen und modifizierten experimentellen APIs im Vergleich zu 2.0-experimental1:

Microsoft.UI.Content

    PopupAnchor

Microsoft.UI.Input

    InputUnderlyingWindowController

Microsoft.UI.Xaml.Controls

    StretchChild
    SystemBackdropHost
    WrapPanel

Microsoft.Windows.AI.Imaging

    ImageForegroundExtractor
    ImageForegroundExtractorContract

Microsoft.Windows.AI.Search.Experimental.AppContentIndex

    AppContentIndexContract
    AppContentIndexer
    AppContentIndexListener
    AppIndexContentRegion
    AppIndexQuery
    AppIndexQueryMatch
    AppIndexQueryOptions
    AppIndexTextStreamEncoding
    AppManagedImageQueryMatch
    AppManagedIndexableAppContent
    AppManagedTextQueryMatch
    ContentItemReader
    ContentItemStatus
    ContentItemStatusResult
    ContentRegionTextOptions
    DeleteIndexResult
    DeleteIndexStatus
    DeleteIndexWhileInUseBehavior
    GetOrCreateIndexOptions
    GetOrCreateIndexResult
    GetOrCreateIndexStatus
    ImageMatchOptions
    ImageQueryMatch
    IndexableAppContent
    IndexCapabilities
    IndexCapabilitiesOfCurrentSystem
    IndexCapability
    IndexCapabilityInitializationStatus
    IndexCapabilityLanguageStatus
    IndexCapabilityOfCurrentSystemStatus
    IndexCapabilityRequirement
    IndexCapabilityState
    IndexStatistics
    QueryMatchContentKind
    QueryMatchScope
    RegionContentKind
    TextLexicalMatchType
    TextMatchOptions
    TextQueryMatch

Microsoft.Windows.AI.Text.Experimental

    LanguageModelExperimental
    LanguageModelExperimentalContract
    LanguageModelOptionsExperimental
    LowRankAdaptation

Microsoft.Windows.Storage.Pickers

    FileOpenPicker
        FileTypeChoices
        SuggestedFolder
        SuggestedStartFolder

    FileSavePicker
        SuggestedStartFolder

    FolderPicker
        SuggestedFolder
        SuggestedStartFolder

• AppContentIndexer APIs sollten aus einem Hintergrundthread aufgerufen werden. Die Nutzung im UI-Thread kann zu einem Einfrieren oder langen Pausen führen, die das Benutzererlebnis beeinträchtigen.
• Abfrageergebnisse mit AppIndexQuery.GetNextTextMatches und AppIndexQuery.GetNextImageMatches sind null, wenn keine Übereinstimmungen vorliegen, anstatt eine leere Liste zurückzugeben.
• Bildübereinstimmungen mithilfe von AppManagedImageQueryMatch.Subregion basierend auf OCR-Werten können gelegentlich ungenau sein, insbesondere wenn der Text gedreht oder verzerrt ist.
• Bildabgleiche mit AppManagedImageQueryMatch.Subregion können manchmal Rechtecke von null Größe oder extrem kleine Rechtecke enthalten, was zu ungenauen Ergebnissen führt.
• Ein Leerabfrage von AppContentIndex.CreateQuery kann eine Ausnahme auslösen.

Mit den Windows ML-Modellkatalog-APIs können Ihre App oder Bibliothek große KI-Modelldateien dynamisch aus Ihren eigenen Onlinemodellkatalogen herunterladen, ohne diese großen Dateien direkt mit Ihrer App oder Bibliothek zu versenden. Darüber hinaus hilft der Modellkatalog beim Filtern, welche Modelle mit dem Windows-Gerät kompatibel sind, auf dem es ausgeführt wird, sodass das richtige Modell auf das Gerät heruntergeladen wird.

Wichtige Vorteile:

• Kataloge hinzufügen: Hinzufügen eines oder mehrerer Onlinekataloge
• Ermitteln kompatibler Modelle: Automatische Suche nach Modellen, die mit den Hardware- und Ausführungsanbietern des Benutzers funktionieren
• Herunterladen von Modellen: Herunterladen und Speichern von Modellen aus verschiedenen Quellen
• Freigeben von Modellen in allen Apps: Wenn mehrere Anwendungen dieselbe Katalogquelle verwenden, werden die Modelle auf dem Datenträger freigegeben, ohne Downloads zu duplizieren

• Es wurde ein Problem in DeploymentManager behoben, das dazu führte, dass PackageInstallRequired in einigen Fällen fälschlicherweise gemeldet wurde.

Diese Version enthält die folgenden neuen und geänderten experimentellen APIs:

Microsoft.UI.Composition

    CompositionNotificationDeferral
    CompositionProjectedShadow
        MaxOpacity
        MinOpacity
        OpacityFalloff

    CompositionProjectedShadowCaster
        AncestorClip
        Mask

    CompositionProjectedShadowDrawOrder
    CompositionProjectedShadowReceiver
        DrawOrder
        Mask

Microsoft.UI.Composition.Experimental

    ExpCompositionVisualSurface
    ExpExpressionNotificationProperty
    IExpCompositionPropertyChanged
    IExpCompositionPropertyChangedListener
    IExpCompositor
    IExpVisual

Microsoft.UI.Content

    ChildSiteLink
        IsBelowContent

    ContentAppWindowBridge
    ContentDisplayOrientations
    ContentExternalBackdropLink
    ContentExternalOutputLink
    ContentIsland
        Connected
        ConnectionInfo
        ConnectRemoteEndpoint
        Disconnected
        IsRemoteEndpointConnected
        Root

    ContentIslandEnvironment
        CurrentOrientation
        NativeOrientation
        ThemeChanged

    ContentSite
        TryGetAutomationProvider

    ContentSiteEnvironment
        CurrentOrientation
        NativeOrientation
        NotifyThemeChanged

    CoreWindowSiteBridge
    CoreWindowTopLevelWindowBridge
    DesktopChildSiteBridge
        AcceptRemoteEndpoint
        ConnectionInfo
        IsRemoteEndpointConnected
        RemoteEndpointConnecting
        RemoteEndpointDisconnected
        RemoteEndpointRequestedStateChanged

    DesktopPopupSiteBridge
        AnchoringBehavior
        AnchoringPixelAlignment

    DesktopSiteBridge
        TryCreatePopupSiteBridge

    EndpointConnectionEventArgs
    EndpointRequestedStateChangedEventArgs
    IContentIslandEndpointConnectionPrivate
    IContentSiteBridgeEndpointConnectionPrivate
    PopupAnchoringOptions
    PopupWindowSiteBridge
    ProcessStarter
    SystemVisualSiteBridge

Microsoft.UI.Input

    InputKeyboardSource
        GetForWindowId

    InputLayoutPolicy
    InputLightDismissAction
        GetForIsland

    InputLightDismissEventArgs
    InputPointerActivationBehavior
    InputPointerSource
        ActivationBehavior
        DirectManipulationHitTest
        GetForVisual
        GetForWindowId
        RemoveForVisual
        TouchHitTesting
        TrySetDeviceKinds

    InputPopupController
    LightDismissReason
    PopupPointerMode
    ProximityEvaluation
    TouchHitTestingEventArgs

Microsoft.UI.Input.Experimental

    ExpInputSite
    ExpPointerPoint

Microsoft.UI.Windowing

    AppWindow
        GetCurrentPlacement
        PersistedStateId
        PlacementRestorationBehavior
        SaveCurrentPlacement
        SaveCurrentPlacementForAllPersistedStateIds
        SetCurrentPlacement

    AppWindowPlacementDetails
    DisplayArea
        GetMetricsFromWindowId

    PlacementInfo
    PlacementRestorationBehavior

Microsoft.UI.Xaml

    XamlIsland
        ShouldConstrainPopupsToWorkArea

Microsoft.UI.Xaml.Automation.Peers

    AutomationEvents
        Notification

    InkCanvasAutomationPeer
    PagerControlAutomationPeer

Microsoft.UI.Xaml.Controls

    ContentDialogPlacement
        UnconstrainedPopup

    DoInkPresenterWork
    ElementFactory
    FlowLayout
    FlowLayoutAnchorInfo
    FlowLayoutLineAlignment
    FlowLayoutState
    IApplicationViewSpanningRects
    IndexPath
    InfoBar
        Opened

    InfoBarOpenedEventArgs
    InkCanvas
    ISelfPlayingAnimatedVisual
    ItemContainer
        CanUserInvoke
        CanUserInvokeProperty
        CanUserSelect
        CanUserSelectProperty
        ItemInvoked
        MultiSelectMode
        MultiSelectModeProperty

    ItemContainerInteractionTrigger
    ItemContainerInvokedEventArgs
    ItemContainerMultiSelectMode
    ItemContainerUserInvokeMode
    ItemContainerUserSelectMode
    LayoutPanel
    NumberBox
        InputScope
        InputScopeProperty
        TextAlignment
        TextAlignmentProperty

    PagerControl
    PagerControlButtonVisibility
    PagerControlDisplayMode
    PagerControlSelectedIndexChangedEventArgs
    PagerControlTemplateSettings
    ProgressRing
        DeterminateSource
        DeterminateSourceProperty
        IndeterminateSource
        IndeterminateSourceProperty

    RecyclePool
    RecyclingElementFactory
    ScrollingScrollStartingEventArgs
    ScrollingZoomStartingEventArgs
    ScrollView
        ScrollStarting
        ZoomStarting

    SelectionModel
    SelectionModelChildrenRequestedEventArgs
    SelectionModelSelectionChangedEventArgs
    SelectTemplateEventArgs
    StackLayout
        IsVirtualizationEnabled
        IsVirtualizationEnabledProperty

    StackLayoutState
    TeachingTip
        Opened

    TeachingTipOpenedEventArgs
    UniformGridLayoutState

Microsoft.UI.Xaml.Controls.Primitives

    ScrollPresenter
        ScrollStarting
        ZoomStarting

Microsoft.Windows.AI.MachineLearning

    CatalogModelInfo
    CatalogModelInstance
    CatalogModelInstanceResult
    CatalogModelSource
    CatalogModelStatus
    WinMLModelCatalog

Microsoft.Windows.ApplicationModel.WindowsAppRuntime

    DeploymentManager
        Repair

    DeploymentStatus
        PackageRepairFailed

Microsoft.Windows.AppNotifications

    AppNotification
        ConferencingConfig

    AppNotificationConferencingConfig

Microsoft.Windows.AppNotifications.Builder

    AppNotificationBuilder
        AddCameraPreview

    AppNotificationButton
        SetSettingStyle

    AppNotificationButtonSettingStyle

Microsoft.Windows.SemanticSearch

    EmbeddingVector
    SemanticSearchContract

Microsoft.Windows.Storage

    ApplicationData
        GetForUnpackaged

Microsoft.Windows.Vision

    ScreenRegionBoundingBox
    ScreenRegionDetectionContract
    ScreenRegionLabel