Sdílet prostřednictvím

Nejnovější poznámky k vydání experimentálního kanálu pro Windows App SDK

Důležitý

Experimentální kanál je nepodporuje pro použití v produkčních prostředích a aplikace, které používají experimentální verze, se nedají publikovat do Microsoft Storu.

Experimentální kanál zahrnuje vydání Windows App SDK s funkcemi a v počátečních fázích vývoje. Atribut Experimentální mají rozhraní API pro experimentální funkce. Pokud ve svém kódu zavoláte experimentální rozhraní API, zobrazí se upozornění při sestavení. Všechna rozhraní API v experimentálním kanálu podléhají rozsáhlým revizem a zásadním změnám. Experimentální funkce a rozhraní API je možné kdykoli odebrat z následujících verzí.

důležité odkazy:

Verze 2.0 Experimentální (2.0.0-Experimentální2)

Důležitý

Pokud jste dříve nainstalovali sadu Windows App SDK 2.0 Experimentální 1, pomocí průvodce odinstalací NuGet odeberte Microsoft.WindowsAppSDK balíček NuGet Metapackage s verzí 2.0.250930001-experimental1 z projektu a přidruženými balíčky součástí WinAppSDK z této verze před pokusem o tuto novou verzi, protože dříve vydaný experimentální balíček má vyšší číslo verze než aktuální.

Hledání obsahu aplikace

Rozhraní API AppContentIndexer umožňují vývojářům efektivně indexovat obsah aplikace, včetně textu a obrázků pro rychlé a relevantní načítání. Podpora lexikálního vyhledávání (založeného na klíčových slovech) i sémantických vyhledávání (založených na významu) tato rozhraní API umožňují aplikacím poskytovat rychlé a relevantní výsledky na základě záměru uživatele a kontextu, a ne jenom přesná klíčová slova.

Tato funkce odemkne následující pokročilé scénáře:

  • Sémantické hledání
    Aplikace můžou vracet výsledky na základě záměru a významu místo přesné shody klíčových slov.
    Příklad: Dotaz na časovou osu projektu může zobrazit obsah, který zmíní "plán" nebo "data doručení", i když se tato přesná slova nepoužila.
  • Retrieval-Augmented Generation (RAG)
    Indexovaný obsah může sloužit jako znalostní báze pro generování modelů AI. Když uživatel položí otázku, aplikace načte z indexu nejrelevantní dokumenty nebo fragmenty kódu a odešle je do modelu, což umožňuje přesné a kontextové odpovědi založené na skutečných datech.

Katalog modelů Windows ML

Rozhraní API katalogu modelů ve Windows ML umožňují vaší aplikaci nebo knihovně dynamicky zjišťovat a stahovat velké soubory modelu AI z vlastních online katalogů modelů, což eliminuje nutnost integrovat tyto velké soubory přímo do vaší aplikace nebo knihovny. Katalog modelů pomáhá zajistit kompatibilitu zařízení filtrováním modelů a stahováním pouze těch, které platí pro konkrétní zařízení s Windows, které se používají.

Umístění trvalých souborů a složek

Nejnovější Microsoft.Windows.Storage.Pickers aktualizace zjednodušuje výběr souborů a složek tím, že vývojářům umožňuje nastavit počáteční a trvalá umístění složek a seskupit filtry typů souborů s jasnými popisky pro snadnější navigaci.

Relativní umístění vyskakovacího okna

Rozhraní PopupAnchor API nyní umožňuje DesktopPopupSiteBridge podporovat relativní umístění ukotvením do vlastního okna nebo ostrůvku, čímž řeší omezení, kdy bylo možné automaticky otevíraná okna umístit pouze absolutně pomocí souřadnic obrazovky.

Směrování vstupu pro SystemVisual ContentIslands

Rozhraní InputUnderlyingWindowController API umožňuje vývojářům určit cílový HWND pro příjem vstupních zpráv, které byly původně odeslány do ContentIsland vytvořené z SystemVisual (viz ContentIsland.CreateForSystemVisual).

Umístění flexibilního pozadí systému

SystemBackdropHost umožňuje umístit systémovou pozadí (akryl/mica) kamkoliv do vizuálního stromu aplikace.

Sekvenční umístění rozložení XAML

Panel WrapPanel je panel rozložení WinUI XAML, který uspořádává podřízené prvky v pořadí zleva doprava, a položky, které přesahují řádek, se automaticky přesunou na další řádek na konci panelu. Je užitečné pro responzivní rozložení.

Toto je port stávajícího ovládacího prvku Windows Community Toolkit.

Nová rozhraní API pro 2.0-experimentální2

Tato verze zahrnuje následující nová a upravená experimentální rozhraní API ve srovnání s 2.0-experimentální1:

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

Známé problémy

  • AppContentIndexer API by se mělo volat z vlákna na pozadí. Použití ve vlákně uživatelského rozhraní může způsobit zaseknutí nebo dlouhé pozastavení, které negativně ovlivní uživatelský zážitek.
  • Výsledky dotazu používající AppIndexQuery.GetNextTextMatches a AppIndexQuery.GetNextImageMatches budou mít hodnotu null, pokud nejsou k dispozici žádné shody místo prázdného seznamu.
  • Shody obrazů pomocí AppManagedImageQueryMatch.Subregion založené na hodnotách OCR mohou být občas nepřesné, zejména pokud je text otočený nebo zkosený.
  • Shody obrázků používající AppManagedImageQueryMatch.Subregion mohou někdy obsahovat nulové nebo extrémně malé obdélníky, což vede k nepřesným výsledkům.
  • Prázdný dotaz z AppContentIndex.CreateQuery může vyvolat výjimku.

Verze 2.0 Experimentální (2.0.0-Experimentální1)

Použití umělé inteligence na zařízení s rozhraními API AI pro Windows

Důležitý

Základní modely STROJOVÉho učení vyžadované pro tato rozhraní API v současné době vyžadují, aby vaše zařízení mělo nejnovější build Windows 11 Insider Preview na vývojovém kanálu. Kromě toho tato rozhraní API vyžadují, aby vaše zařízení bylo počítačem Copilot+. Další informace o těchto zařízeních najdete v Příručce pro vývojáře počítačů Copilot+. Rozhraní API vyvolá výjimku při zavolání na zařízeních, která nemají potřebnou podporu.

Sada Windows App SDK zahrnuje pokročilé funkce umělé inteligence systému Windows, což vývojářům umožňuje bezproblémovou integraci inteligentních funkcí do svých aplikací. Mezi tato vylepšení patří místní funkce umělé inteligence, jako je reakce na příchozí výzvy, rozpoznávání textu v obrázcích, popis obsahu obrázku, extrakce objektů z obrázků a další.

Informace o postupech zodpovědného vývoje využívaných při vytváření rozhraní API umělé inteligence pro Windows, které je možné použít také při vytváření funkcí s asistencí umělé inteligence, najdete v pokynech k vývoji zodpovědných aplikací a funkcí generující AI ve Windows .

Microsoft Windows ML

Rozhraní API katalogu modelů Windows ML umožňují vaší aplikaci nebo knihovně dynamicky stahovat velké soubory AI modelů z vašich vlastních online katalogů modelů, aniž by tyto velké soubory byly přímo součástí vaší aplikace nebo knihovny. Katalog modelů navíc pomůže filtrovat, které modely jsou kompatibilní se zařízením s Windows, na kterém běží, aby se do zařízení stáhl správný model.

Klíčové výhody:

  • Přidání katalogů: Přidání jednoho nebo několika online katalogů
  • Zjišťování kompatibilních modelů: Automatické vyhledání modelů, které pracují s poskytovateli hardwaru a spouštění uživatele
  • Stažení modelů: Stahování a ukládání modelů z různých zdrojů
  • Sdílení modelů napříč aplikacemi: Pokud více aplikací používá stejný zdroj katalogu, budou modely sdíleny na disku bez duplikování stahování.

Opravy chyb

  • Opravili jsme problém v DeploymentManageru, který v některých případech nesprávně hlásil PackageInstallRequired.

Nové API pro 2.0-experimental1

Tato verze zahrnuje následující nová a upravená experimentální rozhraní API:

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

Archiv poznámek k vydání experimentálního kanálu

Rozbalení odkazů na archivované poznámky k verzi experimentálního kanálu
  • Last updated on