Notas de la versión de SDK de Aplicaciones para Windows 2.0

Se ha agregado compatibilidad con la windows.diagnosticServiceModule extensión package-manifest. Las aplicaciones MSIX de .NET independientes pueden usar esta extensión para declarar módulos de diagnóstico, lo que permite que Informes de errores de Windows los cargue y recopile volcados de memoria tras un bloqueo útiles para el análisis.

Las nuevas AppContentIndex API ahora están disponibles como una característica de acceso limitado (LAF) a las aplicaciones que han obtenido un token laF. Estas API permiten que las aplicaciones proporcionen contenido de texto e imagen para indexar y consultar ese contenido con coincidencia léxica y, en dispositivos compatibles con NPU, coincidencia semántica. AppContentIndex admite escenarios de búsqueda semántica y de generación aumentada por recuperación (RAG). (RuntimeCompatibilityChange: AppContentSearchNewAPI_LafCheck)

• Se ha corregido un bloqueo en el control de entradas emergentes en ventanas cuando se procesaba un evento de foco o puntero después de que se hubiera eliminado la isla del elemento emergente. (RuntimeCompatibilityChange: PointerInputProcessor_ReleaseCaptureOnDisposedIsland)
• Se ha corregido un fallo en NavigationView al cambiar el tamaño del control, que podía producir un panel con tamaño negativo MaxHeight. (RuntimeCompatibilityChange: NavigationView_UpdatePaneLayoutNegativeMaxHeight)
• Se ha corregido un problema por el que el conjunto de propiedades devuelto por ElementCompositionPreview.GetPointerPositionPropertySet detuvo la actualización mientras se presionaba un puntero. (Cambio de compatibilidad en tiempo de ejecución: Conjunto de propiedades de posición del puntero_Actualizar mientras se presiona)
• Se corrigió un error que provocaba un cierre inesperado en NavigationView cuando se mostraba el menú flotante de un elemento expandido después de que el elemento se hubiera contraído o reciclado. (RuntimeCompatibilityChange: NavigationViewItem_DeferredFlyoutShowStaleState)
• Se ha corregido un fallo inmediato que se producía al usar una tecla OEM o de puntuación KeyboardAccelerator, como una coma, un punto y coma o un corchete, y al mostrar la etiqueta del método abreviado del acelerador. (RuntimeCompatibilityChange: KeyboardAccelerator_OemKeyNoFailFast)
• Se ha corregido una finalización fatal del proceso que podía producirse durante el cierre de XAML en aplicaciones que alojan WinUI 3 en más de un hilo de interfaz de usuario. (RuntimeCompatibilityChange: WindowsXamlManager_ActivationFactoryCacheResetRace)
• Se ha corregido un problema por el que un CommandBar sin comandos secundarios podía mostrar un botón de desbordamiento vacío en escalas de visualización fraccionaria, como 175%. (Cambio de compatibilidad en tiempo de ejecución: CommandBar_SpuriousOverflowButtonAtFractionalScale)
• Se ha corregido un problema que impedía que las aplicaciones que usan el motor de composición del sistema llamaran a VisualInteractionSource.CreateFromIVisualElement. (RuntimeCompatibilityChange: CompositionEngine_SwitcherSeptemberFixes)
• Gráficos de efectos fijos y SceneLighting representación para aplicaciones que usan el motor de composición del sistema. (RuntimeCompatibilityChange: CompositionEngine_SwitcherSeptemberFixes)
• Se corrigió que InputPointerSource.ActivationBehavior no respetara NoActivate al usar el motor de composición del sistema. (RuntimeCompatibilityChange: CompositionEngine_SwitcherSeptemberFixes)
• Se ha corregido CompositionEngine el comportamiento de selección para las entradas nulas y las selecciones de no-op. (RuntimeCompatibilityChange: CompositionEngine_SwitcherSeptemberFixes)
• Se ha corregido la personalización del cursor para la entrada levantada al usar el motor de composición del sistema. (RuntimeCompatibilityChange: CompositionEngine_SwitcherSeptemberFixes)
• Se han corregido las consultas ICompositionObject sobre colecciones de paradas de degradado al usar el motor de composición del sistema. (RuntimeCompatibilityChange: N/A, corrección de composición del sistema operativo)
• Se ha corregido el comportamiento de los ContentExternalOutputLink bordes y fondos al usar el motor de composición del sistema. (RuntimeCompatibilityChange: N/A, corrección de composición del sistema operativo)
• Se ha corregido el acceso a VisualReferenceController al usar el Motor de composición del sistema. (RuntimeCompatibilityChange: N/A, corrección de composición del sistema operativo)
• Se ha corregido un problema de registro que podía producirse al instalar el SDK de Aplicaciones para Windows. (RuntimeCompatibilityChange: N/A, corrección de registro de implementación)
• Se ha corregido un problema por el que la superresolución de vídeo podía fallar durante la inicialización o la inferencia con la dependencia actualizada de ONNX Runtime. (RuntimeCompatibilityChange: N/A, actualización de compatibilidad de dependencias)

Esta versión incluye las siguientes API nuevas en comparación con la versión 2.4.0:

Microsoft.Windows.Search.AppContentIndex

    AppIndexContentRegion
        CreateFromBitmap
        CreateFromImageStream

    AppManagedIndexableAppContent
        CreateFromBitmap
        CreateFromImageStream

    ContentRegionImageOptions

    ContentRegionTextOptions
        AllowSemanticIndexing

    ImageOcrIndexingOptions

Las aplicaciones WinUI 3 ahora admiten la respuesta háptica del panel táctil y del ratón del sistema operativo a través de Windows.Devices.Haptics, junto con el desplazamiento con un solo dedo en el panel táctil, cuando el sistema operativo y el hardware lo admiten. (RuntimeCompatibilityChange: InputPointerSource_OSHaptics)

• Se ha corregido un fallo que podía producirse cuando un toque o un trazo con el lápiz salía de un área desplazable en un momento preciso. (RuntimeCompatibilityChange: InputPointerSource_DepartingScrollInputCrashFix)
• Se ha corregido un problema por el que los selectores de almacenamiento (FileOpenPicker, FileSavePicker y FolderPicker) dejaban la ventana de la aplicación WinUI que los invocaba sin el foco del teclado tras cerrarse el cuadro de diálogo de archivos. La aplicación ahora restaura su enfoque anterior después de que se cierre el cuadro de diálogo. Para obtener más información, consulta GitHub problema n.º 6505. (RuntimeCompatibilityChange: StoragePickers_RestoreFocusAfterDialogCloses)
• Se ha corregido una regresión por la que MrmGetFilePathFromName devolvía ERROR_FILE_NOT_FOUND cuando el archivo PRI no existía, en lugar de devolver la ruta alternativa documentada. Para obtener más información, consulta GitHub problema n.º 5940. (RuntimeCompatibilityChange: ResourceManager_RestoreDefaultFallbackPath)
• Se ha corregido un problema por el que los procesos secundarios podían heredar MICROSOFT_WINDOWSAPPRUNTIME_BASE_DIRECTORY, lo que interrumpía MRT Core y las búsquedas en el catálogo. Para obtener más información, consulta GitHub problema n.º 5987. (RuntimeCompatibilityChange: WindowsAppRuntime_BaseDirectoryIsolation)
• Se ha corregido un problema por el que LanguageModel devolvía el estado genérico Error para idiomas no admitidos o idiomas de entrada y salida no coincidentes. Estas condiciones ahora devuelven LanguageModelResponseStatus.UnsupportedLanguage y LanguageModelResponseStatus.LanguageMismatch, respectivamente. (RuntimeCompatibilityChange: LanguageModel_LanguageDetectionStatus)
• Se ha corregido un fallo que provocaba un bloqueo cuando las aplicaciones que utilizan el motor de composición del sistema invocaban VisualInteractionSource.TryRedirectForManipulation. (RuntimeCompatibilityChange: N/A, corrección de un problema en el puente de composición del sistema operativo)
• Se ha corregido el modificador de acceso en el asistente de punto de entrada de C# generado cuando se define DISABLE_XAML_GENERATED_MAIN. Para obtener más información, consulta GitHub problema n.º 11245. (RuntimeCompatibilityChange: N/A, cambio de herramientas en tiempo de compilación)

Esta versión incluye las siguientes API nuevas en comparación con la versión 2.3.1:

Microsoft.Windows.AI.Text

    LanguageModelResponseStatus
        LanguageMismatch
        UnsupportedLanguage

Se agregó la API de salida JSON estructurada (Microsoft.Windows.AI.Text.LanguageModel.GenerateStructuredJsonResponseAsync), que genera respuestas del modelo de lenguaje restringidas a un esquema JSON proporcionado por el autor de la llamada. (RuntimeCompatibilityChange: LanguageModel_StructuredJsonOutput)

Se agregó la API XamlOptionalChanges , que permite a las aplicaciones participar en cambios importantes opcionales antes de la inicialización de XAML. Para obtener más información, vea GitHub PR microsoft/microsoft-ui-xaml#11110. (RuntimeCompatibilityChange: XamlSettings_OptionalChangesApi)

Se ha cambiado el comportamiento de la DISABLE_XAML_GENERATED_MAIN constante de preprocesador para que, cuando se defina, cambie el nombre del método generado main() (C#: XamlGeneratedProgram.XamlGeneratedMain(); C++/WinRT: wXamlGeneratedMain()) en lugar de quitarlo completamente. Esto permite que un método personalizado main() invoque la implementación predeterminada.

Se agregó CompositionEngine API como una característica de acceso limitado inestable (LAF), que permite a las aplicaciones participar en el uso del sistema operativo como motor de las API de composición. (RuntimeCompatibilityChange: CompositionEngine_API)

Se ha corregido la detección de NPU, se ha agregado compatibilidad con la CPU y se ha mejorado el rendimiento de la super resolución de vídeo. (RuntimeCompatibilityChange: VideoSuperResolution_HardwareDetection)

• Se ha corregido la enumeración del proveedor de ejecución en determinados escenarios. (RuntimeCompatibilityChange: WindowsML_ExecutionProviderEnumerationUpdate)
• Se ha agregado compatibilidad con ARM64EC para Windows ML.

Se ha agregado documentación de IntelliSense para las API estables en el paquete NuGet Microsoft.WindowsAppSDK.AI.

Varias de las optimizaciones siguientes son opcionales. Para habilitarlos, establezca el xamlChangeId especificado como se indica en cada elemento.

• Se han agregado nuevos estilos optimizados XamlControlsResources , incluida una plantilla optimizada ScrollBar . Usa el DefaultStyleOptimizations XamlChangeId para habilitar estos estilos. (RuntimeCompatibilityChange: Xaml_DefaultStyleOptimizations)
• FontIcon y BitmapIcon evitan insertar un Grid adicional en su árbol visual en las aplicaciones que se adhieran mediante el XamlChangeId IconNoGridOptimization. (RuntimeCompatibilityChange: Xaml_IconNoGridOptimization)
• Se detuvo la carga Style de establecedores de propiedades que no aplican un valor. Use XamlChangeId OptimizeApplyStyles para participar. (RuntimeCompatibilityChange: Xaml_DeferStylePropertySetters)
• Se ha retrasado la aplicación de los estilos FrameworkElement y Control hasta que el elemento forme parte del árbol. Use XamlChangeId OptimizeApplyStyles para participar. (RuntimeCompatibilityChange: Xaml_DelayApplyStylesAfterCreationComplete)
• Se ha optimizado la inicialización de CommandBar al dejar de cargar todo el estado del administrador de estados visuales. (RuntimeCompatibilityChange: Xaml_OptimizedCommandBarInitialization)
• Se ha mejorado el rendimiento al añadir a los elementos CommandBarFlyout y PrimaryCommands de SecondaryCommands. (RuntimeCompatibilityChange: Xaml_OptimizedCommandBarFlyoutUpdateCommands)
• Se usa una tabla hash más eficaz para ResourceDictionary. (RuntimeCompatibilityChange: Xaml_FasterResourceDictionary)
• Se eliminó mediante optimización una copia y una comparación de la cadena de la clave de recurso al cargar recursos diferidos. (RuntimeCompatibilityChange: Xaml_LoadDeferredResourceOptimization)
• Se ha mejorado el rendimiento de las búsquedas de ThemeResource al reducir las comparaciones de cadenas. (RuntimeCompatibilityChange: Xaml_ThemeResourceUseResourceKeys)
• Se ha mejorado el rendimiento de la CPU durante la búsqueda de recursos de tema de XAML al reducir la sobrecarga del cálculo hash de las claves de recurso. (RuntimeCompatibilityChange: Xaml_ReduceThemeResourceLookupHashing)
• Se ha mejorado el rendimiento de la CPU para comprobaciones comunes de tipos XAML internos en UIElement y FrameworkElement. (RuntimeCompatibilityChange: Xaml_CachedTypeChecks)
• Se ha mejorado el rendimiento de la CPU en las rutas de búsqueda internas de la factoría de activación. (RuntimeCompatibilityChange: Xaml_ActivationFactoryFastPaths)
• Rendimiento mejorado de la descodificación de enteros almacenados en archivos XBF. (RuntimeCompatibilityChange: Xaml_FasterXbfIntLoading)
• Se han reducido las asignaciones de montón en rutas de inicio y recorrido de árbol reservando memoria vectorial y optimizando un asistente RAII. (RuntimeCompatibilityChange: Xaml_ReserveVectorSpace)
• Se ha mejorado el rendimiento reservando espacio en las colecciones del rastreador antes de añadir varios elementos. (RuntimeCompatibilityChange: Xaml_ReserveTrackerCollectionSpace)
• Enlaces de propiedades optimizados para XamlUICommand. (RuntimeCompatibilityChange: XamlUICommand_LightweightBindings)
• Mejora del rendimiento al vincular XamlUICommand que no definen aceleradores de teclado. (RuntimeCompatibilityChange: XamlUICommand_SkipEmptyKeyboardAcceleratorBinding)
• Se inicializó la propiedad en el marcado TintLuminosityOpacity para los objetos AcrylicBrush de estilo predeterminado, en lugar de hacerlo en el código, evitando así la instanciación forzada. (RuntimeCompatibilityChange: AcrylicBrush_InitializePropertyInMarkup)
• Se ha evitado la inicialización predeterminada ContextFlyout innecesaria en TextBlock y RichTextBlock al entrar o salir del árbol de elementos. Use XamlChangeId DeferContextFlyoutInit para participar. (RuntimeCompatibilityChange: Xaml_DeferContextFlyoutInit)
• Se redujo la espera de inicio causada por la contención de bloqueos en Direct3D al registrar el evento de retirada del dispositivo D3D de XAML durante la creación del dispositivo en segundo plano, en lugar de hacerlo posteriormente en el subproceso de la interfaz de usuario. (RuntimeCompatibilityChange: Xaml_EagerDeviceRemovedEventRegistration)
• Se ha eliminado un registro redundante de notificaciones de alimentación de RefreshRateInfo, lo que reduce la sobrecarga de inicio. (RuntimeCompatibilityChange: RefreshRateInfo_RemovePowerNotification)
• Se ha quitado una dependencia redundante version.dll de la ruta de inicio de WinUI mediante la computación de la versión en tiempo de ejecución registrada en tiempo de compilación. (RuntimeCompatibilityChange: XamlInit_GetMuxVersionCompileTime)

• Se ha corregido un fallo por uso de memoria ya liberada en CPopupRoot::ReplayPointerUpdate cuando una ventana emergente se cierra de forma sincrónica durante la reproducción de eventos de puntero. (RuntimeCompatibilityChange: CPopupRoot_ReplayPointerUpdateCrash)
• Se ha corregido una infracción de acceso en CXamlIslandRoot::GetScreenOffset desencadenada por consultas reentrantes de Automatización de la interfaz de usuario durante el desmontaje de islas XAML. (RuntimeCompatibilityChange: XamlIslandRoot_UiaTeardownReentrancyCrash)
• Se ha corregido un cierre inesperado en ModernCollectionBasePanel por el que un contenedor o encabezado seguido por la ventana gráfica, reciclado durante una pasada de diseño de un elemento hermano, podía dejar un ancla obsoleta que provocara un fallo inmediato en la siguiente medición. (RuntimeCompatibilityChange: ModernCollectionBasePanel_StaleViewportAnchorRecycle)
• Se ha corregido un error rápido en CPopup::RemoveChild cuando un cierre ToolTip bombeaba los mensajes y volvía a entrar en la ruta de acceso de cierre. (RuntimeCompatibilityChange: Popup_RemoveChildIdempotentWhenClosing)
• Se ha corregido un fallo por reentrada en CXcpDispatcher cuando el destructor de Popup desencadenaba UIADisconnectAllProviders con clientes de Automatización de la interfaz de usuario activos. (RuntimeCompatibilityChange: UIAWindow_PauseNewDispatchOnDisconnectProviders)
• Se corrigió un cierre inesperado que se producía cuando se activaba un menú de cascada o el temporizador de apertura diferida AutoSuggestBox después de que la isla o el despachador propietarios hubieran iniciado su desmantelamiento. (RuntimeCompatibilityChange: CascadingMenuHelper_DelayOpenTimerTickAfterUnload)
• Se ha corregido un posible bloqueo por acceso a memoria ya liberada durante la descarga de una DLL, cuando los punteros COM de tipos de metadatos personalizados no se liberaban correctamente. (RuntimeCompatibilityChange: CustomMetadataTypes_InvalidateUseAfterFree)
• Se ha corregido un cierre inesperado al abrir un Popup desde un callback de CompositionTarget.Rendering debido a la reentrada del dispatcher al cambiar el foco. (RuntimeCompatibilityChange: CPopup_OpenSetFocusReentrancy)
• Se ha corregido un fallo en MediaPlayerPresenter cuando el dispositivo de la GPU deja de estar disponible durante la gestión de eventos de reproducción multimedia. (RuntimeCompatibilityChange: MediaPlayerPresenter_DeviceLostCrash)
• Se ha corregido una posible infracción de acceso en el renderizado de texto de Direct2D cuando se producía la recuperación tras la pérdida del dispositivo durante la generación de texturas para secuencias de glifos. (RuntimeCompatibilityChange: HWBuildGlyphRunTextures_DeviceGuardScope)
• Se ha corregido un fallo en CFocusRectManager::FindFocusRectHost cuando el foco pasa a un control alojado en línea mediante InlineUIContainer en RichTextBlock o TextBlock. (RuntimeCompatibilityChange: FocusRectManager_FindFocusRectHostCrash)
• Se ha corregido un fallo que podía hacer que backgroundTaskHost.exe se cerrara repetidamente cuando una tarea en segundo plano no tenía ningún CLSID almacenado, y se ha añadido un control adecuado cuando CoCreateInstance falla. Para obtener más información, consulta GitHub problema n.º 5870. (RuntimeCompatibilityChange: UniversalBGTask_RunCrash)
• Se ha corregido la desalineación de los menús desplegables con y sin ventana, que aparecían aproximadamente a la altura de un elemento por encima del elemento primario, en las ubicaciones laterales cuando se abrían hacia arriba cerca de la parte inferior de la pantalla. (RuntimeCompatibilityChange: Flyout_SidePlacementFlipUpAlignmentFix)
• Se ha corregido un fallo (desreferenciación de null LayoutState) en UniformGridLayout y FlowLayout que podía producirse cuando se notificaba un cambio en la colección de un ItemsRepeater que ya no estaba cargado. (RuntimeCompatibilityChange: UniformGridLayoutFlowLayout_OnItemsChangedNullLayoutStateCrash)
• Se corrigió ApplicationData.GetForUnpackaged().LocalSettings() la apertura de una clave del registro en una ruta incorrecta (HKCU\SOFTWARE\publisher\product en lugar de HKCU\SOFTWARE\Classes\Local Settings\Software\publisher\product), que es una ubicación de itinerancia en lugar de una ubicación local al equipo. Para obtener más información, consulta GitHub problema n.º 6559. (RuntimeCompatibilityChange: ApplicationData_GetForUnpackaged_LocalSettings)
• Se ha corregido una condición de carrera en el control del estado modificador del teclado que podía bloquear las aplicaciones en la entrada simultánea del subproceso de la interfaz de usuario. (RuntimeCompatibilityChange: WindowsServices_GetKeyboardModifiersStateRace)
• Se ha corregido un bloqueo de AppxSvc que puede producirse durante la instalación, actualización o desinstalación del paquete. (RuntimeCompatibilityChange: N/A, corrección de bloqueos del host de servicio)

Esta versión incluye las siguientes API nuevas en comparación con la versión 2.2.0:

Microsoft.UI.Composition

    CompositionEngine
    CompositionEngineType

Microsoft.UI.Xaml.Settings

    XamlChangeId
    XamlOptionalChanges

Microsoft.Windows.AI.Text

    GenerateStructuredJsonResponseResult
    GenerateStructuredJsonResponseStatus
    LanguageModel
        GenerateStructuredJsonResponseAsync

La Microsoft.Windows.AI.Video.VideoScaler API ofrece mejoras de vídeo en tiempo real a través del escalado avanzado de inteligencia artificial, optimizado para secuencias con personas en conversación. Permite a los desarrolladores proporcionar visuales más nítidos y claros en las plataformas de videoconferencia, streaming y edición, incluso en condiciones de red deficientes. La API admite la personalización de la resolución de salida, la velocidad de fotogramas y las regiones de interés, con compatibilidad con varios formatos de vídeo, incluidos BGR, RGB y NV12.

VideoScaler es descartable e incluye una comprobación de funcionalidad para que las aplicaciones puedan validar la compatibilidad con VSR en tiempo de ejecución. No se requiere la inicialización explícita Windows ML.

Una nueva Microsoft.Windows.Storage.ApplicationData.GetForUnpackaged() API ofrece a las aplicaciones sin empaquetar un punto de entrada principal de WinRT a los datos de aplicación por usuario o por equipo, con una superficie de API equivalente a la que antes solo estaba disponible para las aplicaciones empaquetadas. Esto simplifica las futuras migraciones entre versiones empaquetadas y no empaquetadas y elimina la necesidad de soluciones alternativas para la API del Registro.

Se han agregado sobrecargas sin boxing para establecer valores a XamlBindingHelper (SetPropertyFromThickness, SetPropertyFromCornerRadius, SetPropertyFromColor) y se ha expuesto la propiedad de dependencia Setter.ValueProperty.

• Se ha corregido un bloqueo en RenderTargetBitmap cuando el elemento de destino sale del árbol visual (por ejemplo, cuando se cierra un elemento emergente) antes de que PreCommit se complete. RenderAsync ahora devuelve E_ABORT en lugar de bloquearse. (RuntimeCompatibilityChange: RenderTargetBitmap_PreCommitCrashOnTreeLeave)
• Se ha corregido un fallo de uso tras liberación en ScrollView cuando el control se destruye mientras el temporizador de ocultación de indicadores sigue pendiente. Para obtener más información, consulta GitHub problema #10514. (RuntimeCompatibilityChange: ScrollView_HideIndicatorsTimerUseAfterFree)
• Se ha corregido un posible cierre inesperado en Microsoft.UI.Xaml.dll!DirectUI::DXamlCore::GetPeerPrivate provocado por un intento de acceder a un objeto marcado para su liberación. (RuntimeCompatibilityChange: GetPeerPrivate_UseAfterFree)
• Se ha corregido un problema por el que Microsoft.UI.System.ThemeSettings podía provocar el bloqueo de una aplicación si se destruía en un hilo en segundo plano (por ejemplo, al ser destruido por el recolector de basura de .NET). (RuntimeCompatibilityChange: ThemeSettings_OffThreadDestructorFix)
• Se ha corregido un fallo que podía producirse en determinados dispositivos cuando los contactos táctiles activos se cancelaban por el dispositivo de entrada, como cuando la entrada del lápiz los sustituye. (RuntimeCompatibilityChange: InputPointerSource_PointerCancelCrashFix)
• Se ha corregido un problema por el que las aplicaciones empaquetadas dispersas no podían detectar archivos PRI específicos del módulo. Para obtener más información, consulte GitHub problema #6375. (RuntimeCompatibilityChange: MRTCore_SparsePackagedPriFallback)
• Se ha corregido un error en la propiedad de cadenas al usar la API del catálogo de ML de Flat-C para Windows. (RuntimeCompatibilityChange: WindowsMLFlatCCatalog_CallbackStringOwnership)
• Se ha corregido un posible problema en Windows ML durante el apagado del proceso. (RuntimeCompatibilityChange: WindowsML_ComRundownFix)
• Se han corregido posibles problemas de inicialización y desinicialización de COM en Windows ML. (RuntimeCompatibilityChange: WindowsML_ComInitializationFix)

Esta versión incluye las siguientes API nuevas en comparación con la versión 2.1.3:

Microsoft.UI.Xaml

    Setter
        ValueProperty

Microsoft.UI.Xaml.Markup

    XamlBindingHelper
        SetPropertyFromColor
        SetPropertyFromCornerRadius
        SetPropertyFromThickness

Microsoft.Windows.AI.Video

    VideoScaler
    VideoScalerOptions
    VideoScalerResult
    VideoScalerStatus

Microsoft.Windows.Storage

    ApplicationData
        GetForUnpackaged

Mejora cómo TitleBar determina qué partes de TitleBar.Content se pueden arrastrar y añade API que ofrecen a los desarrolladores un control explícito sobre las regiones de arrastre de TitleBar.Content. Consulte PR microsoft/microsoft-ui-xaml#10936 y problema de seguimiento n.º 10421.

Qué ha cambiado

• Nuevo comportamiento predeterminado : el marco ahora recorre de forma recursiva el árbol visual y excluye automáticamente solo los controles interactivos de la región de arrastre. Los espacios vacíos y los objetos visuales no interactivos se pueden arrastrar de forma predeterminada, sin que se requieran cambios de marcado.
• Nuevas API para el control explícito:
  • TitleBar.IsDragRegion — booleano anulable asociado para marcar un elemento como arrastrable (True), en el que se puede hacer clic (False) o determinado por el framework (sin establecer).
  • TitleBar.AutoRefreshDragRegions — cuando True, las regiones de arrastre se actualizan automáticamente al actualizarse el diseño.
  • TitleBar.RecomputeDragRegions() — vuelve a calcular manualmente las áreas de arrastre tras cambios dinámicos en el contenido.

Por qué

Las barras de título personalizadas suelen mezclar controles interactivos con objetos visuales no interactivos dentro Grid/StackPanel de diseños. El enfoque anterior de «recortar zonas del área completa de contenido» dejaba zonas inesperadas que no se podían arrastrar en diseños con espacios vacíos, espaciado irregular o interfaces dinámicas.

Comparación visual

Comportamiento predeterminado (anterior): huecos no arrastrables:

El área central vacía no se puede arrastrar.

Comportamiento actual (nuevo) — espacios arrastrables y controles interactivos excluidos:

El espacio vacío es arrastrable; Los controles interactivos se excluyen correctamente. (RuntimeCompatibilityChange: TitleBar_ContentDragRegions)

La API de Low-Rank Adapter (LoRA) para Phi Silica ha pasado a ser estable.

LoRA permite a los desarrolladores ajustar el modelo de lenguaje PhiLice en el dispositivo con sus propios datos personalizados, alineando la salida para escenarios específicos, como finanzas, médicos y educación. Cargue un adaptador con LanguageModelLowRankAdapter.CreateFromPath y páselo a través de LanguageModelOptions.LowRankAdapter al llamar a GenerateResponseAsync. Consulte PhiLice LoRA para obtener más información.

Una nueva API AICapabilities.HasAICapability permite a las aplicaciones de terceros determinar si el dispositivo es un Copilot+ PC.

La versión de ONNX Runtime se ha actualizado a la versión 1.24.6. Consulte Versiones de ONNX Runtime para obtener más información.

• Se ha agregado compatibilidad con varios proveedores de ejecución dentro de un único paquete MSIX. (RuntimeCompatibilityChange: WindowsML_MultiEpPerPackage)
• Se ha agregado compatibilidad para detectar proveedores de ejecución entregados como paquetes de marco. (RuntimeCompatibilityChange: WindowsML_FrameworkEpEnumeration)
• Se ha agregado el modo de selección del proveedor de ejecución para configuraciones de implementación flexibles. (RuntimeCompatibilityChange: WindowsML_EpSelectionMode)

• Se ha corregido una fuga de memoria en ItemsRepeater en la que los elementos reciclados nunca eran eliminados por el recolector de basura debido a un ciclo de referencias a través de RecyclePool, lo que también podía provocar fallos en InvalidateChildrenMeasure. (RuntimeCompatibilityChange: ItemTemplateWrapper_RecyclePoolLeak)
• Se ha corregido un fallo por el que una función de devolución de llamada de finalización de una animación implícita de mostrar/ocultar podía acceder a un objeto destruido CUIElement, lo que provocaba una infracción de acceso. La función de devolución de llamada ahora usa una referencia débil para gestionar correctamente el caso en el que el elemento se destruye antes de que se complete la animación. (RuntimeCompatibilityChange: Animation_FixImplicitHideAnimationCrash)
• Se ha corregido un problema por el que el contenido de ventana emergente abierto en una isla XAML no respetaba OverrideScale, provocando que el contenido apareciera demasiado grande y recortado. Para obtener más información, consulta GitHub problema #11000. (RuntimeCompatibilityChange: Popup_WindowedPopupOverrideScale)
• Se ha corregido un bloqueo de tipo fail-fast causado por un despacho reentrante durante operaciones de liberación COM entre apartamentos en UIAffinityReleaseQueue::DoCleanup. (RuntimeCompatibilityChange: UIAffinityReleaseQueue_PauseDispatchDuringCleanup)
• WinUI: se ha corregido la búsqueda de módulos ambiguos cuando se cargan varios módulos con el mismo nombre en el mismo proceso. GetModuleHandleW se ha reemplazado por GetModuleHandleExW para que el módulo correcto se resuelva por dirección. (RuntimeCompatibilityChange: GetModuleHandle_FixAmbiguousModuleLookup)
• Se ha corregido un fallo por división entera entre cero en UniformGridLayout::GetMajorSize cuando un ItemsRepeater se dispone en un ancho disponible inferior al paso menor de un elemento. (RuntimeCompatibilityChange: UniformGridLayout_GetItemsPerLineDivideByZero)
• Se ha corregido un posible bloqueo cuando se ha desinstalado un paquete antes de procesarse. (RuntimeCompatibilityChange: PackageManager_FixCrash)
• Se ha corregido un problema por el que GetReadyState podía devolver códigos de error incorrectos (por ejemplo, DisabledByUser o NotSupportedOnCurrentSystem) cuando los paquetes necesarios aún no se implementaban. La API ahora informa NotReady correctamente en este escenario, lo que mejora la claridad del diagnóstico. (RuntimeCompatibilityChange: ModelInitialization_GetReadyStateAvailabilityGuard)
• Se ha mejorado el diagnóstico de rendimiento interno para LanguageModel.GenerateResponseAsync identificar mejor los orígenes de latencia antes de que se devuelva el primer token. (RuntimeCompatibilityChange: LanguageModelInsights_GetPartialResultLatency)
• Se ha corregido un problema por el que los errores del compilador XAML se perdían silenciosamente al usar dotnet build, mostrando solo MSB3073: exited with code 1 en lugar de los mensajes de error reales. Para obtener más información, consulta GitHub problema #9813. (RuntimeCompatibilityChange: N/A, cambio de herramientas del compilador XAML en tiempo de compilación)
• Se ha corregido un problema por el que Microsoft.Windows.Workloads.dll no se cargaba en compilaciones de Windows anteriores a 22000 debido a importaciones estáticas de las API de dependencias dinámicas no disponibles en esas versiones del sistema operativo. Las funciones ahora se resuelven dinámicamente, por lo que los fallos en versiones no compatibles del sistema operativo aparecen como un HRESULT normal en lugar de un cuadro de diálogo de error del cargador. (RuntimeCompatibilityChange: N/A, sin contención)

Esta versión incluye las siguientes API nuevas en comparación con la versión 2.0.1:

Microsoft.UI.Xaml.Controls

    TitleBar
        AutoRefreshDragRegions
        AutoRefreshDragRegionsProperty
        GetIsDragRegion
        IsDragRegionProperty
        RecomputeDragRegions
        SetIsDragRegion

Microsoft.Windows.AI

    AICapabilities

    AICapabilityCategory

Microsoft.Windows.AI.Text

    LanguageModelLowRankAdapter

    LanguageModelLowRankAdapterResult

    LanguageModelOptions
        LowRankAdapter

    LanguageModelResponseStatus
        IncompatibleLowRankAdapter

SDK de Aplicaciones para Windows 2.0 es la primera versión del nuevo esquema de control de versiones de SDK de Aplicaciones para Windows, estandarizado en Semantic Versioning 2.0.0. También es la primera vez que incrementamos el número de versión principal.

El nuevo esquema simplifica el control de versiones alineando la versión de SDK de Aplicaciones para Windows con la versión del paquete NuGet. Hacer referencia a SDK de Aplicaciones para Windows 2.0 en tu proyecto ahora significa que usarás la versión de NuGet correspondiente, sin ningún número de compilación basado en fechas independiente que rastrear.

<PackageDependency Name="Microsoft.WindowsAppSDK" Version="2.0.1" />

El nombre de familia del paquete también se alinea con la versión principal en lugar de la versión secundaria, por lo que la próxima versión en paralelo de SDK de Aplicaciones para Windows será la versión 3.0.0. En SemVer, solo se permiten cambios importantes en las actualizaciones de versiones principales (consulte arquitectura de implementación de SDK de Aplicaciones para Windows).

El paquete NuGet Microsoft.WindowsAppSDK.ML se ha refactorizado, agregando una nueva dependencia base. La funcionalidad del paquete NuGet de ML existente sigue siendo la misma, pero las características principales Windows ML se han refactorizado en un paquete base denominado Microsoft.Windows.AI.MachineLearning. Este nuevo paquete contiene un conjunto mínimo de dependencias y admite aplicaciones hasta Windows 10 v1903. Si necesita compatibilidad con Windows 10 v1809, siga usando el paquete Microsoft.WindowsAppSDK.ML existente.

ONNX Runtime. La versión de ONNX Runtime incluida con Windows ML se ha actualizado a la versión 1.24.5. Consulte Versiones de ONNX Runtime para obtener más información. Esta versión también incluye un cambio de API ORT adicional para admitir la compilación de modelos mediante gráficos producidos mediante la API OrtModelEditor (una brecha de características en la interfaz anterior OrtCompileApi). El cambio no es disruptivo y se tomó para desbloquear los próximos escenarios del navegador WebNN; consulte el PR de ONNX Runtime N.º 27332 para más detalles.

Licencias. El contrato de licencia de ML de Windows se ha simplificado con términos más claros para los ISV:

• Secciones de instalación, datos y código distribuible reestructuradas para mayor claridad.
• Una nueva sección de aviso de cumplimiento del proveedor de ejecución (EP) aclara las responsabilidades del desarrollador con respecto a los proveedores de ejecución acelerados por hardware.
• Vínculos directos a contratos de licencia de proveedor para NVIDIA TensorRT, Intel OpenVINO y Qualcomm QNN (SDK de red neuronal de Qualcomm).

• Las API de PhiLice ahora se aplican como parte de una característica de acceso limitado (LAF). Consulte PhiLice para obtener más información.
• Se han agregado nuevos estados para ayudar a AIFeatureReadyState las aplicaciones a explicar errores transitorios y duraderos durante el proceso de adquisición del modelo de IA: CapabilityMissing, NotCompatibleWithSystemHardwarey OSUpdateNeeded. Las aplicaciones pueden usar estos estados para proporcionar a los usuarios instrucciones procesables en lugar de tratar cada condición "no preparada" como un error genérico.
• Se han agregado comprobaciones de varios errores de red y Windows Update durante la instalación del modelo de IA, lo que marca los errores duraderos para que los usuarios puedan comprender por qué los paquetes de modelo no se pudieron instalar.
• Se ha mejorado el diagnóstico de las API de Text Intelligence que se usan en escenarios de inteligencia artificial de Windows.

Se ha habilitado la compatibilidad de arrastre para el contenido de WebView2 hospedado en aplicaciones winUI 3. Esta funcionalidad no se admitía anteriormente y ahora está disponible sin introducir nuevas API públicas. (Ya se admite el arrastre en un control WebView2 desde fuentes externas).

Escenarios admitidos:

• Contenido de arrastrar y soltar estándar. Se admite arrastrar texto, HTML, imágenes y direcciones URL. Al arrastrar una imagen fuera de la aplicación, se produce actualmente un nombre de archivo predeterminado (por ejemplo, download.jpg) cuando se coloca en el Explorador de archivos.
• Arrastre la cancelación. Se admite la cancelación bajo demanda de una operación de arrastre activa, de modo que una aplicación puede bloquear condicionalmente las operaciones de arrastre de contenido restringido o efímero después de que se inicie el arrastre.
• Objetos visuales de arrastre personalizados. Se admite la interfaz de usuario de arrastrar personalizada, como iconos o vistas previas, para ayudar a los usuarios a identificar claramente el contenido que se está arrastrando.
• Datos de arrastre personalizables. Se admite la edición y personalización de los datos de arrastre, lo que habilita escenarios específicos para aplicaciones, como arrastrar mensajes dentro de la aplicación o adjuntar datos contextuales (por ejemplo, "Desde la aplicación <nombre>") que el destino puede interpretar al soltar.

Limitaciones:

• Actualmente no se admiten algunos tipos de datos de arrastre adicionales, incluido DownloadURL.

Requisitos:

• Versión mínima del entorno de ejecución de WebView2 (canal beta de Edge): 144.0.3719.11.

La API de Microsoft.Windows.Storage.Pickers (introducida en SDK de Aplicaciones para Windows 1.8) se ha ampliado para simplificar la selección de archivos y carpetas al permitir a los desarrolladores establecer ubicaciones iniciales y persistentes de carpetas y filtros de tipo de archivo de grupo con etiquetas claras para facilitar la navegación.

• FileOpenPicker agrega FileTypeChoices, InitialFileTypeIndex, SettingsIdentifier, SuggestedFolder, SuggestedStartFoldery Title.
• FileSavePicker agrega InitialFileTypeIndex, SettingsIdentifier, ShowOverwritePrompt, SuggestedStartFoldery Title.
• FolderPicker agrega PickMultipleFoldersAsync, SettingsIdentifier, SuggestedFolder, SuggestedStartFoldery Title.

• Posicionamiento relativo de ventanas emergentes. La nueva PopupAnchor API permite que DesktopPopupSiteBridge admita el posicionamiento relativo anclando a su ventana o isla propietaria, solucionando la limitación por la cual los elementos emergentes solo podían posicionarse de forma absoluta usando coordenadas de pantalla. Las nuevas propiedades DesktopPopupSiteBridge.AnchoringBehavior y DesktopPopupSiteBridge.AnchoringPixelAlignment controlan el comportamiento de anclaje.
• Guía de atajos de teclado. La nueva InputFocusController.ShouldShowKeyboardCues propiedad guía a los desarrolladores acerca de si deben mostrar las indicaciones del teclado justo después de la creación de un ContentIsland.
• API de conveniencia de PointerPoint. El método PointerPoint.GetCurrentPoint nuevo permite a los desarrolladores obtener los datos activos PointerPoint de un pointerId proporcionado.

El nuevo Microsoft.UI.Xaml.Controls.SystemBackdropElement es un FrameworkElement ligero que permite a las aplicaciones colocar un fondo del sistema como Mica o Acrílico en cualquier parte del diseño XAML, con una propiedad CornerRadius para áreas redondeadas del fondo. Cierra una brecha de WinUI 3 de larga duración, donde los efectos acrílicos en la aplicación (anteriormente sencillos en WinUI 2 a través de AcrylicBrush.BackgroundSource) no tenían un equivalente directo.

El espacio de nombres Microsoft.Windows.Management.Deployment agrega un marco de validación de paquetes y una API de PackageVolume para administrar los volúmenes de almacenamiento en los que se almacenan provisionalmente los paquetes.

• Validadores. Nueva IPackageValidator interfaz más tres validadores integrados (PackageCertificateEkuValidator, PackageFamilyNameValidator, PackageMinimumVersionValidator) que se pueden adjuntar a AddPackageOptions / StagePackageOptions a través de la nueva PackageValidators propiedad. PackageValidationEventArgs, PackageValidationEventSource y PackageValidationHandler manejan eventos de validación; IsPackageValidationSupported y GetValidationEventSourceForUri permiten que los llamantes verifiquen soporte antes de invocar la implementación.
• Volumen del Paquete. Nuevo PackageVolume tipo con GetDefault, GetPackageVolumeByName, GetPackageVolumeByPath, AddAsync, RemoveAsync, GetAvailableSpaceAsync, IsOffline, SetDefault, SetOfflineAsync, SetOnlineAsync y IsFeatureSupported para la detección de funcionalidad en tiempo de ejecución (PackageVolumeFeature).

La nueva IXamlCondition interfaz permite a los desarrolladores definir condiciones personalizadas que se integran con la sintaxis del espacio de nombres condicional de XAML y se evalúan durante el análisis de XAML. Esto reemplaza la interfaz experimental IXamlPredicate . Las condiciones personalizadas permiten escenarios XAML condicionales basados en factores específicos de la aplicación, como marcas de características, funcionalidades de dispositivo, lógica de negocios, opciones de configuración y otras condiciones en tiempo de ejecución.

• Se ha corregido un problema por el que el instalador de WindowsAppSDK no mostraba ningún progreso durante la instalación, lo que hace que aparezca detenido. El instalador ahora proporciona comentarios de progreso más claros.
• Se ha mejorado el control de errores para escenarios donde WindowsAppSDKSelfContained está habilitado para las bibliotecas de clases.
• Se corrigieron las advertencias de compilación MSB8027 y LNK4042 causadas por elementos duplicados ClCompile en los archivos .targets NuGet SDK de Aplicaciones para Windows moviendo las definiciones de preprocesador de bloques <Target> a <ItemDefinitionGroup>. Se incluye una solución alternativa de exclusión (WindowsAppSDK_Arm64EcCompilerWorkaround) para las compilaciones de ARM64EC+LTCG para evitar un error conocido del compilador interno de MSVC.
• Se ha corregido un bloqueo de ListView que podía producirse durante la navegación por el teclado (Tab/Mayús+Tab) después de actualizar la lista de elementos.
• Se ha corregido un problema por el cual WinUI 3 podía bloquearse si el foco se moviera al CoreWebView2Controller mientras el controlador no estaba visible.
• Se ha mejorado DeleteIndex la fiabilidad, lo cual evita que ERROR_SHARING_VIOLATION falle en algunos escenarios (Búsqueda de Contenido de Aplicación; permanece en el canal experimental).
• Se han corregido cuadros de límite de OCR que devuelven valores negativos en algunos casos extremos.
• Se ha corregido un error de Windows ML en el que llamar a RegisterCertifiedAsync de nuevo en el mismo proceso devolvía incorrectamente 0 proveedores de ejecución (EP).

Esta versión contiene una refactorización de referencias transitivas de NuGet. Para actualizar un proyecto de C++ existente, se recomienda usar herramientas (nuget.exe o Visual Studio) para quitar la referencia del paquete de SDK de Aplicaciones para Windows existente y agregar la nueva referencia. Esto soluciona los problemas de actualización en proyectos basados en packages.config.

Actualización desde la versión 2.0 Experimental7. El paquete experimental Microsoft.WindowsAppSDK.ML se envió con un número de revisión superior al 2.0.0 estable, lo que puede aparecer como un error de degradación de NuGet (especialmente en proyectos de C++). Si estaba en Experimental7, siga la guía de desinstalación de NuGet para quitar el paquete experimental antes de hacer referencia a 2.0.0.

• La búsqueda de contenido de la aplicación sigue siendo experimental. La interfaz de API de Microsoft.Windows.Search.AppContentIndex (Búsqueda de contenido de la aplicación) se eliminó en la versión 2.0-Preview2 para mejorar los fundamentos y asegurar la compatibilidad futura. No se incluye en la versión estable 2.0.1. Para experimentar con él, siga usando versiones experimentales. Si instaló previamente el paquete experimental Microsoft.Windows.Search, desinstálelo a través de la guía NuGet Uninstall antes de pasar a la versión 2.0.1 estable.
• Las API ya se han enviado en el servicio 1.8. Algunas características experimentales que se previsualizaron durante el ciclo 2.0 se promocionaron a api estables en versiones de mantenimiento 1.8 y, por lo tanto, no son nuevas en la versión 2.0.1. Incluyen ModelCatalog (1.8.3), TextRewriter.RewriteCustomAsync (1.8.4), y SplitMenuFlyoutItem más SplitMenuFlyoutItemAutomationPeer (1.8.6). Consulte las notas de la versión 1.8 para obtener más información.

• AICapabilities falta en la versión 2.0.1. Microsoft.Windows.AI.AICapabilities y AICapabilityCategory.CopilotPlusPCCapable (una verificación de capacidades de Copilot+ PC) se lanzó en la versión 1.8.7, pero no se incluyó en la versión 2.0.1. Tenemos previsto restaurarlos en la versión de mayo.

Esta versión incluye las siguientes API nuevas en comparación con la versión estable 1.8.7:

Microsoft.Graphics.Imaging

    ImageBufferPixelFormat
        Bgr8

Microsoft.UI.Content

    DesktopPopupSiteBridge
        AnchoringBehavior
        AnchoringPixelAlignment

    PopupAnchor

Microsoft.UI.Input

    InputFocusController
        ShouldShowKeyboardCues

    PointerPoint
        GetCurrentPoint

Microsoft.UI.Xaml.Controls

    SystemBackdropElement

Microsoft.UI.Xaml.Markup

    IXamlCondition

Microsoft.Windows.AI

    AIFeatureReadyState
        CapabilityMissing
        NotCompatibleWithSystemHardware
        OSUpdateNeeded

Microsoft.Windows.Management.Deployment

    AddPackageOptions
        GetValidationEventSourceForUri
        IsPackageValidationSupported
        PackageValidators

    IPackageValidator
    PackageCertificateEkuValidator
    PackageFamilyNameValidator
    PackageMinimumVersionValidator
    PackageValidationEventArgs
    PackageValidationEventSource
    PackageValidationHandler
    PackageVolume
        AddAsync
        GetAvailableSpaceAsync
        GetDefault
        GetPackageVolumeByName
        GetPackageVolumeByPath
        IsFeatureSupported
        IsOffline
        RemoveAsync
        SetDefault
        SetOfflineAsync
        SetOnlineAsync

    PackageVolumeFeature
    StagePackageOptions
        GetValidationEventSourceForUri
        IsPackageValidationSupported
        PackageValidators

Microsoft.Windows.SemanticSearch

    EmbeddingVector
    SemanticSearchContract

Microsoft.Windows.Storage.Pickers

    FileOpenPicker
        FileTypeChoices
        InitialFileTypeIndex
        SettingsIdentifier
        SuggestedFolder
        SuggestedStartFolder
        Title

    FileSavePicker
        InitialFileTypeIndex
        SettingsIdentifier
        ShowOverwritePrompt
        SuggestedStartFolder
        Title

    FolderPicker
        PickMultipleFoldersAsync
        SettingsIdentifier
        SuggestedFolder
        SuggestedStartFolder
        Title

Microsoft.Windows.Vision

    ScreenRegionBoundingBox
    ScreenRegionDetectionContract
    ScreenRegionLabel

Microsoft.Windows.AI

    AIFeatureReadyState
        CapabilityMissing
        NotCompatibleWithSystemHardware
        OSUpdateNeeded

El paquete NuGet Microsoft.WindowsAppSDK.ML se ha refactorizado, agregando una nueva dependencia base. La funcionalidad del paquete NuGet de ML existente sigue siendo la misma, pero las características principales Windows ML se han refactorizado en un paquete dependiente base denominado Microsoft.Windows. IA. MachineLearning. Este nuevo paquete contiene un conjunto mínimo de dependencias, pero en C#/WinRT o C++/WinRT solo admite hasta Windows 10 18362. Si necesita compatibilidad con Windows 10 17763, use el paquete Microsoft.WindowsAppSDK.ML existente.

Para las nuevas dependencias transitivas, se recomienda usar herramientas para actualizar el paquete (nuget.exe o VS). Consulte también: Notas del lanzamiento de SDK de Aplicaciones para Windows 1.6.

La versión de ONNX Runtime se ha actualizado a la versión 1.24.4. Consulte Versiones de ONNX Runtime para obtener más información.

Se hicieron obligatorias las API de Phi Silica para convertirse en una característica de acceso limitado.

Se han agregado comprobaciones de varios errores de red y Windows Update durante la instalación del modelo de IA, lo que marca los errores duraderos para que los usuarios puedan comprender por qué los paquetes de modelo no se pudieron instalar.

Se ha mejorado el diagnóstico de las API de Text Intelligence que se usan en escenarios de inteligencia artificial de Windows.

La búsqueda de contenido de la aplicación se ha quitado de la versión preliminar 2.0 mientras trabajamos para mejorar los aspectos básicos y garantizar la compatibilidad futura a medida que cambian los modelos de IA subyacentes. Mientras tanto, siga usando el canal experimental para probar los cambios más recientes.

Se ha habilitado la compatibilidad de arrastre para el contenido de WebView2 hospedado en aplicaciones winUI 3. Esta funcionalidad no se admitía anteriormente y ahora está disponible sin introducir nuevas API públicas. Nota: Ya se admite la importación en WebView2 desde orígenes externos.

Escenarios compatibles

• Contenido de arrastrar y colocar estándar Se admite arrastrar texto, HTML, imágenes y direcciones URL. En función del comportamiento actual, arrastrar imágenes fuera de la aplicación da como resultado un nombre de archivo predeterminado (por ejemplo, download.jpg) cuando se coloca en el Explorador de archivos. Escenario de ejemplo: Un usuario selecciona texto o una imagen dentro de WebView2 y lo arrastra dentro de la aplicación o a otro destino, como el Explorador de archivos.

• Cancelación de arrastre Se admite la cancelación bajo demanda de una operación de arrastre activa. Escenario de ejemplo: Una aplicación bloquea condicionalmente las operaciones de arrastrar para determinados tipos de contenido (como contenido restringido o efímero) cancelando la arrastrar después de iniciarse.

• Objetos visuales de arrastre personalizados Se admite la interfaz de usuario de arrastrar personalizada, como iconos o vistas previas, para ayudar a los usuarios a identificar claramente el contenido que se está arrastrando. Escenario de ejemplo: Una aplicación muestra una miniatura o un icono al arrastrar contenido multimedia, lo que deja claro qué elemento se está moviendo actualmente.

• Datos de arrastre personalizables Se admite la edición y personalización de los datos de arrastre, lo que permite escenarios específicos de la aplicación, como arrastrar mensajes dentro de la aplicación (por ejemplo, como una interacción alternativa para el reenvío de mensajes). Escenario de ejemplo: Una aplicación personaliza la carga de arrastre para incluir metadatos contextuales, como el nombre de la aplicación de origen. Cuando se quita el contenido, el destino puede mostrar o procesar información como "Desde <el nombre> de la aplicación" para indicar el origen del contenido arrastrado.

Limitaciones

• La compatibilidad con tipos de datos de arrastre adicionales es limitada. Actualmente no se admiten los siguientes formatos:
  • DownloadURL

Requisitos

• Versión mínima del entorno de ejecución de WebView2 (canal beta de Edge): 144.0.3719.11

La interfaz IXamlCondition permite a los desarrolladores definir condiciones personalizadas que se integran con la sintaxis del espacio de nombres condicional de XAML y se evalúan en el tiempo de análisis de XAML. Se trata de un cambio de nombre y una graduación de la interfaz experimental IXamlPredicate . Las condiciones personalizadas permiten escenarios XAML condicionales basados en factores específicos de la aplicación, como marcas de características, funcionalidades de dispositivo, lógica de negocios, opciones de configuración y otras condiciones en tiempo de ejecución.

• Se han corregido las advertencias de compilación MSB8027 y LNK4042 causadas por elementos ClCompile duplicados en los archivos .targets del SDK de aplicaciones de Windows de NuGet moviendo las definiciones de preprocesador desde los bloques <Target> a <ItemDefinitionGroup>. Se incluye una solución alternativa de exclusión (WindowsAppSDK_Arm64EcCompilerWorkaround) para las compilaciones de ARM64EC+LTCG para evitar un error conocido del compilador interno de MSVC.
• Se ha corregido un bloqueo de ListView que podía producirse durante la navegación por el teclado (Tab/Mayús+Tab) después de actualizar la lista de elementos.
• Se ha corregido un problema por el que WinUI 3 podía bloquearse si el foco se movió a CoreWebView2Controller mientras el controlador no estaba visible.

Esta versión incluye las siguientes API nuevas y modificadas en comparación con 2.0-Preview1:

Microsoft.UI.Xaml.Markup

    IXamlCondition

• La versión de ONNX Runtime en Windows ML se ha actualizado a 1.24 RC.
• Se ha corregido un error en el que si se llama a RegisterCertifiedAsync de nuevo en el mismo proceso, devuelve incorrectamente 0 proveedores de ejecución (EP)

• Nueva InputFocusController.ShouldShowKeyboardCues propiedad para guiar a los desarrolladores sobre si mostrar las indicaciones del teclado justo después de la creación de un ContentIsland.
• Nueva API práctica PointerPoint.GetCurrentPoint, para que los desarrolladores obtengan los datos activos PointerPoint del pointerId proporcionado.

• Confiabilidad mejorada DeleteIndex . A veces DeleteIndex fallaría con ERROR_SHARING_VIOLATION.

• Corrección para cuadros de límite de OCR que devuelven valores negativos en algunos casos extremos.

• La búsqueda de contenido de la aplicación forma parte de un paquete de Microsoft.Windows.Search independiente en lugar de formar parte de Microsoft.Windows.AI package.

• Corrección para la búsqueda de prefijos que no funcionan con cadenas de consulta cortas.

• Nuevas API y cambios de nombre basados en la revisión oficial de la API.

  • IndexadorDeContenidoDeApp
    • ObtenerElementosDeContenidoQueRequierenReindexación
    • Remove -> EliminarElementoDeContenido
    • RemoveMultiple:> RemoveContentItems
    • EliminarTodosLosElementosDeContenido
    • GetContentIndexingStatus-> GetContentItemStatus
    • GetMultipleContentIndexingStatus -> GetContentItemStatuses
    • ObtenerElementosDeContenido
  • AppContentIndexListener
    • EstadoDeIndexaciónCambiado:> EstadoDeElementoDeContenidoCambiado
  • AppIndexTextQuerySession
    • UpdateQuery:> UpdateQueryPhrase
    • ResultadoMásReciente-> ObtenerResultado
    • MostRecentResultChanged -> ResultChanged
  • AppIndexImageQuerySession
    • UpdateQuery:> UpdateQueryPhrase
    • ResultadoMásReciente-> ObtenerResultado
    • MostRecentResultChanged -> ResultChanged
  • AppManagedImageQueryMatch
    • Subregión-> RegiónDeInterés
  • ResultadoDeEstadoDelElementoDeContenido
    • Estado de Reindexación * Estado de Reindexación de Elementos de Contenido
  • TextQuerySessionResult
    • IsValid
  • ImageQuerySessionResult
    • IsValid
  • QueryContentItemsFilterFlags

• Se ha corregido un problema por el que el instalador de WindowsAppSDK no mostraba ningún progreso durante la instalación, lo que hace que aparezca detenido. El instalador ahora proporciona comentarios de progreso más claros.
• Se ha mejorado el control de errores de escenarios en los que WindowsAppSDKSelfContained está habilitado para las bibliotecas de clases.

Esta versión incluye las siguientes API experimentales nuevas y modificadas en comparación con la versión 1.8.5:

---

Microsoft.Graphics.Imaging

    ImageBufferPixelFormat
        Bgr8

Microsoft.UI.Content

    DesktopPopupSiteBridge
        AnchoringBehavior
        AnchoringPixelAlignment

    PopupAnchor

Microsoft.UI.Input

    InputFocusController
        ShouldShowKeyboardCues

    PointerPoint
        GetCurrentPoint

Microsoft.UI.Xaml.Automation.Peers

    SplitMenuFlyoutItemAutomationPeer

Microsoft.UI.Xaml.Controls

    SplitMenuFlyoutItem
    SystemBackdropElement

Microsoft.Windows.Management.Deployment

    AddPackageOptions
        GetValidationEventSourceForUri
        IsPackageValidationSupported
        PackageValidators

    IPackageValidator
    PackageCertificateEkuValidator
    PackageFamilyNameValidator
    PackageMinimumVersionValidator
    PackageValidationEventArgs
    PackageValidationEventSource
    PackageValidationHandler
    PackageVolume
        AddAsync
        GetAvailableSpaceAsync
        GetDefault
        GetPackageVolumeByName
        GetPackageVolumeByPath
        IsFeatureSupported
        IsOffline
        RemoveAsync
        SetDefault
        SetOfflineAsync
        SetOnlineAsync

    PackageVolumeFeature
    StagePackageOptions
        GetValidationEventSourceForUri
        IsPackageValidationSupported
        PackageValidators

Microsoft.Windows.Search.AppContentIndex

    AppContentIndexContract
    AppContentIndexer
    AppContentIndexListener
    AppIndexContentRegion
    AppIndexImageQuery
    AppIndexImageQuerySession
    AppIndexQueryMatch
    AppIndexTextQuery
    AppIndexTextQuerySession
    AppIndexTextStreamEncoding
    AppManagedImageQueryMatch
    AppManagedIndexableAppContent
    AppManagedTextQueryMatch
    ContentItemErrorDetail
    ContentItemReader
    ContentItemReindexingStatus
    ContentItemStatus
    ContentItemStatusResult
    ContentRegionTextOptions
    DeleteIndexResult
    DeleteIndexStatus
    DeleteIndexWhileInUseBehavior
    GetOrCreateIndexOptions
    GetOrCreateIndexResult
    GetOrCreateIndexStatus
    ImageQueryMatch
    ImageQueryOptions
    ImageQuerySessionResult
    IndexableAppContent
    IndexCapabilities
    IndexCapabilitiesOfCurrentSystem
    IndexCapability
    IndexCapabilityInitializationStatus
    IndexCapabilityLanguageStatus
    IndexCapabilityOfCurrentSystemStatus
    IndexCapabilityRequirement
    IndexCapabilityState
    IndexStatistics
    QueryContentItemsFilterFlags
    QueryMatchContentKind
    QueryMatchScope
    RegionContentKind
    TextLexicalMatchType
    TextQueryMatch
    TextQueryOptions
    TextQuerySessionResult

Microsoft.Windows.SemanticSearch

    EmbeddingVector
    SemanticSearchContract

Microsoft.Windows.Storage.Pickers

    FileOpenPicker
        FileTypeChoices
        InitialFileTypeIndex
        SettingsIdentifier
        SuggestedFolder
        SuggestedStartFolder
        Title

    FileSavePicker
        InitialFileTypeIndex
        SettingsIdentifier
        ShowOverwritePrompt
        SuggestedStartFolder
        Title

    FolderPicker
        PickMultipleFoldersAsync
        SettingsIdentifier
        SuggestedFolder
        SuggestedStartFolder
        Title

Microsoft.Windows.Vision

    ScreenRegionBoundingBox
    ScreenRegionDetectionContract
    ScreenRegionLabel

• Las nuevas API AIComputeDevice permiten a las aplicaciones seleccionar el dispositivo de ejecución predeterminado, CPU o NPU al crear un TextRecognizer. ContentRegionImageOptions.PreferredTextRecognizerDevice ofrece la misma preferencia de dispositivo para el OCR realizado durante la indexación de imágenes de App Content Index.
• Ai Speech ahora usa SpeechRecognitionModelFactory y SpeechRecognitionModelFactoryOptions para configurar y crear modelos de reconocimiento de voz. Los métodos de entrada de audio ahora aceptan búferes de muestra de 16 bits, el reconocimiento continuo se detiene de forma asincrónica y los eventos de reconocimiento de streaming exponen propiedades específicas del proveedor.
• LanguageModel.ModelName, LanguageModel.ModelVersion y LanguageModelLowRankAdapterStatus permiten a las aplicaciones identificar el modelo de lenguaje instalado e inspeccionar el resultado de compatibilidad al cargar un adaptador de rango bajo.
• LanguageModelResponseStatus.BlockedByGameMode y LanguageModelResponseStatus.LowOnVram identifican las respuestas que no se pudieron completar porque el modo de juego estaba activo o la memoria de vídeo disponible era baja.

La nueva API experimental FrameworkElement.SetThemeResourceBinding permite a las aplicaciones crear el equivalente de un {ThemeResource} enlace a partir del código. (RuntimeCompatibilityChange: WinUI_SetThemeResourceBinding)

Un nuevo constructor DataTemplate experimental acepta un delegado proporcionado por la aplicación que crea el subárbol del elemento de la plantilla. (RuntimeCompatibilityChange: WinUI_DataTemplateFromDelegate)

El control TableView experimental ahora está disponible en los WinMD públicos. Admite la agrupación con encabezados de grupo basados en plantillas, la ordenación y el filtrado con indicadores de ordenación en los encabezados de columna, el redimensionamiento de columnas mediante puntero y teclado, y descripciones emergentes opcionales para las celdas y los encabezados de columna. (RuntimeCompatibilityChange: TableView_TabularBinaryActivation)

Esta versión incorpora un control experimental de WinUI 3 Chart para mostrar datos cartesianos en series de líneas, áreas y barras. El control admite ejes, leyendas, etiquetas de datos y marcadores de datos configurables. (RuntimeCompatibilityChange: Charts_ExperimentalControlApi)

• Se ha agregado InkPresenter.ActivateCustomDrying y InkSynchronizer, lo que permite que las aplicaciones rendericen por sí mismas la tinta confirmada usando BeginDry y EndDry.
• Se ha corregido una infracción de acceso que podía producirse al leer InkPresenter.StrokeContainer mientras el secado personalizado estaba activo.
• Se corrigió el ajuste de tamaño del presentador de InkCanvas bajo un RenderTransform.
• Alineó la API experimental InkToolbar con el diseño revisado. La barra de herramientas ahora tiene como destino inkPresenter directamente sin necesidad de inkCanvas. (RuntimeCompatibilityChange: InkCanvas_InkingSupport)

• Se ha corregido un problema de seguimiento de recursos de WinUI que podía provocar que el uso de memoria aumentara cuando las aplicaciones crearon repetidamente guiones gráficos de estado visual o recursos estáticos o de tema resueltos. (RuntimeCompatibilityChange: WinUI_ResourceGraphExpiredDependencyPruning)
• Se ha mejorado la limpieza de objetos nativos de WinUI inalcanzables en aplicaciones .NET tras cerrar una pestaña o página. (RuntimeCompatibilityChange: WinUI_OrphanedObjectGCCollection)

Esta versión incluye las siguientes API nuevas y actualizadas en comparación con la versión experimental 2.4 :

Microsoft.UI.Xaml

    DataTemplate
        DataTemplate (elementFactory)

    DataTemplateElementFactory

    FrameworkElement
        SetThemeResourceBinding

Microsoft.UI.Xaml.Controls

    InkPresenter
        ActivateCustomDrying
        HighContrastAdjustment

    InkToolbar
        TargetInkPresenter

    InkStrokeInput
        InkPresenter

    InkSynchronizer

    InkUnprocessedInput
        InkPresenter

Microsoft.UI.Xaml.Controls.Charts

    AreaSeries
    Axis
    BarOrientation
    BarSeries
    CartesianAxis
    CartesianSeries
    CategoryAxis
    CategorySortKey
    Chart
    DataLabelOverride
    DataMarkerOverride
    DateTimeAxis
    DateTimeIntervalType
    GridLines
    LinearAxis
    LineSeries
    MarkerShape
    Samples
    SortOrder
    StrokeDashStyle
    WinUIChartingContract
    XamlChartsResources

Microsoft.UI.Xaml.Controls.Tabular

    ITableViewSortComparer
    SortDirection
    TableView
    TableViewAutomationPeer
    TableViewBeginningEditEventArgs
    TableViewCellAutomationPeer
    TableViewCellEditEndingEventArgs
    TableViewCellsPanel
    TableViewColumn
    TableViewColumnHeaderAutomationPeer
    TableViewDensity
    TableViewEditAction
    TableViewFrozenEdge
    TableViewGridLinesVisibility
    TableViewGroupHeader
    TableViewGroupHeaderAutomationPeer
    TableViewGroupHeaderToggleRequestedEventArgs
    TableViewGroupInfo
    TableViewHeadersVisibility
    TableViewIdentitySelector
    TableViewKeySelector
    TableViewPredicate
    TableViewRow
    TableViewRowAutomationPeer
    TableViewRowTemplateSelector
    TableViewSelectionMode
    TableViewSortCycle
    TableViewSortedEventArgs
    TableViewSortingEventArgs
    TableViewSource
    TableViewTemplateColumn
    TableViewTextColumn
    TabularControlsResources

Microsoft.UI.Xaml.XamlTypeInfo

    XamlControlsChartsXamlMetaDataProvider
    XamlControlsTabularXamlMetaDataProvider

Microsoft.Windows.AI

    AIComputeContract
    AIComputeDevice

Microsoft.Windows.AI.Imaging

    TextRecognizer
        CreateAsync
        EnsureReadyAsync
        GetReadyState

Microsoft.Windows.AI.Speech

    BatchRecognition
        Recognize

    SpeechAudioProvider
        PushData

    SpeechRecognitionModelFactory
    SpeechRecognitionModelFactoryOptions

    StreamingRecognition
        StopContinuousRecognitionAsync

    StreamingRecognizedEventArgs
        GetProperty

    StreamingRecognizingEventArgs
        GetProperty

Microsoft.Windows.AI.Text

    LanguageModel
        ModelName
        ModelVersion

    LanguageModelLowRankAdapterResult
        Status

    LanguageModelLowRankAdapterStatus

    LanguageModelResponseStatus
        BlockedByGameMode
        LowOnVram

Microsoft.Windows.Search.AppContentIndex

    ContentRegionImageOptions
        PreferredTextRecognizerDevice

Esta versión añade compatibilidad con la entrada de lápiz para WinUI 3 mediante InkCanvas, InkToolbar y InkPresenter, incluida la entrada mediante lápiz y táctil, la compatibilidad con el portapapeles, la compatibilidad con alto contraste, la entrada por trazos y la entrada sin procesar. (RuntimeCompatibilityChange: InkCanvas_InkingSupport)

Esta versión incluye las siguientes API nuevas en comparación con la versión experimental 2.3 A :

Microsoft.UI.Xaml.Automation.Peers

    InkToolbarAutomationPeer
    InkToolbarFlyoutItemAutomationPeer
    InkToolbarMenuButtonAutomationPeer
    InkToolbarToolButtonAutomationPeer

Microsoft.UI.Xaml.Controls

    InkCanvas
        InkPresenter

    InkHighContrastAdjustment
    InkInputConfiguration
    InkInputProcessingConfiguration
    InkInputProcessingMode
    InkInputRightDragAction
    InkPresenter
    InkStrokeContainer
    InkStrokeInput
    InkStrokesCollectedEventArgs
    InkStrokesErasedEventArgs
    InkToolbar
    InkToolbarBallpointPenButton
    InkToolbarButtonFlyoutPlacement
    InkToolbarCustomPen
    InkToolbarCustomPenButton
    InkToolbarCustomToggleButton
    InkToolbarCustomToolButton
    InkToolbarEraserButton
    InkToolbarEraserFlyoutItemClickedEventArgs
    InkToolbarEraserFlyoutItemKind
    InkToolbarEraserKind
    InkToolbarFlyoutItem
    InkToolbarFlyoutItemKind
    InkToolbarHighlighterButton
    InkToolbarInitialControls
    InkToolbarIsStencilButtonCheckedChangedEventArgs
    InkToolbarMenuButton
    InkToolbarMenuKind
    InkToolbarPenButton
    InkToolbarPencilButton
    InkToolbarPenConfigurationControl
    InkToolbarRulerButton
    InkToolbarStencilButton
    InkToolbarStencilKind
    InkToolbarToggle
    InkToolbarToggleButton
    InkToolbarTool
    InkToolbarToolButton
    InkUnprocessedInput

Microsoft.Windows.AI.Text

    LanguageModelResponseStatus
        LanguageMismatch
        UnsupportedLanguage

Las nuevas propiedades experimentales Window.Width y Window.Height proporcionan a las aplicaciones una forma adaptada a PPP de obtener y definir directamente, desde código o lenguaje de marcado, el tamaño de una ventana en píxeles lógicos (del cliente), sin tener que pasar por Window.AppWindow ni realizar una conversión manual de PPP lógicos a físicos. Las propiedades Companion Window.MinWidth, Window.MinHeight, Window.MaxWidth y Window.MaxHeight restringen el tamaño de la ventana. Agradecemos sus comentarios.

SpeechAudioProvider experimental (que se usa para insertar audio PCM de 16 kHz, de 16 bits y de un solo canal en el reconocimiento de voz) ahora implementa IClosable, por lo que las aplicaciones pueden liberar deterministamente el proveedor con Close/Dispose cuando terminen de transmitir audio.

Las API experimentales de índice de contenido de aplicaciones agregan nuevas funcionalidades de indexación y mejoras significativas de confiabilidad y rendimiento en esta versión:

• Indexación por lotes más rápida. Una nueva API AppContentIndexer.BatchAddOrUpdate permite indexar varios elementos juntos. La canalización de indexación también se ha rediseñado para admitir la ejecución de fases paralelas y un procesamiento por lotes más eficaz.
• Tokenización multilingüe mejorada. El índice de contenido de la aplicación ahora usa un segmentador de palabras basado en ICU, lo que mejora la precisión de la tokenización en distintos idiomas al tiempo que elimina la dependencia de WinRT WordsSegmenter.
• Se ha mejorado la indexación y el rendimiento de las consultas. Las actualizaciones de índices ahora evitan reescrituras léxicas innecesarias, el trabajo de limpieza por lotes funciona de forma más eficaz y las funcionalidades de índice de caché en las consultas, lo que reduce considerablemente la sobrecarga en las rutas de acceso comunes de consulta e indexación.
• Clasificación léxica más estable. La puntuación de BM25 mantiene ahora las estadísticas de longitud de los documentos de forma independiente, manteniendo una clasificación coherente a medida que el contenido se actualiza o elimina de forma incremental.
• Recuperación automática de datos dañados. El índice de contenido de la aplicación detecta daños en la base de datos y cambios de esquema incompatibles al abrir un índice y se recupera automáticamente iniciando una reindexación en lugar de dejar el índice inutilizable. GetOrCreateIndexStatus.RecoveredFromCorruption indica cuándo se produjo la recuperación.
• Mejoras en la clasificación estática. Las nuevas API permiten a las aplicaciones aplicar mejoras de posicionamiento a elementos de contenido o regiones individuales, lo que permite sesgar los resultados mediante señales proporcionadas por la aplicación. Usa potenciaciones estáticas cuando la aplicación tenga conocimiento sobre la importancia relativa del contenido que no captura el propio contenido, por ejemplo, para ayudar a exponer un documento que sea especialmente importante o que los usuarios busquen habitualmente.
• Indexación de contenido de imagen. Las aplicaciones ahora pueden indexar contenido de mapa de bits o de flujo de imágenes directamente, con opciones que controlan la extracción de OCR y la indexación semántica del texto extraído. Use la indexación de imágenes cuando la información que se pueda buscar significativa se encuentra en una imagen en lugar de estar disponible como texto, como capturas de pantalla, documentos escaneados u otro contenido visual.
• Control de indexación semántica para texto. Una nueva propiedad ContentRegionTextOptions.AllowSemanticIndexing permite que las aplicaciones opten por regiones de texto individuales fuera de la indexación semántica. Esto es útil para el texto que debe seguir pudiendo buscarse de forma léxica, pero que probablemente no se beneficie del emparejamiento semántico, lo que da a las aplicaciones un mayor control sobre qué contenido participa en la recuperación semántica.

Esta versión incluye las siguientes API nuevas en comparación con la versión 2.2 Experimental 9 :

Microsoft.UI.Composition

    CompositionEngine
    CompositionEngineType

Microsoft.UI.Xaml

    Window
        Height
        MaxHeight
        MaxWidth
        MinHeight
        MinWidth
        Width

Microsoft.UI.Xaml.Settings

    XamlChangeId
    XamlOptionalChanges

Microsoft.Windows.AI.Speech

    SpeechAudioProvider
        Dispose

Microsoft.Windows.AI.Text

    GenerateStructuredJsonResponseResult
    GenerateStructuredJsonResponseStatus
    LanguageModel
        GenerateStructuredJsonResponseAsync

Microsoft.Windows.Search.AppContentIndex

    AppContentIndexer
        BatchAddOrUpdate
        GetContentStaticBoost
        GetRegionStaticBoost
        ResetAllStaticBoosts
        SetContentStaticBoost
        SetRegionStaticBoost

    AppIndexContentRegion
        CreateFromBitmap
        CreateFromImageStream
        StaticBoost

    AppManagedIndexableAppContent
        CreateFromBitmap
        CreateFromImageStream

    BatchAddOrUpdateItemResult
    BatchAddOrUpdateResult
    ContentRegionImageOptions
    ContentRegionTextOptions
        AllowSemanticIndexing

    GetOrCreateIndexStatus
        RecoveredFromCorruption

    ImageOcrIndexingOptions
    IndexableAppContent
        StaticBoost

Las API del modelo de lenguaje ahora se ejecutan en PCs sin Copilot+ equipados con una GPU compatible, lo que lleva las capacidades de modelo de lenguaje local a una gama más amplia de dispositivos con Windows 11. El hardware compatible incluye la serie NVIDIA GeForce RTX 30 y versiones posteriores con vRAM de 6+ GB. La inferencia con GPU requiere que el Modo de desarrollador esté activado y una compilación del canal experimental de Windows Insider.

El modelo de GPU no está preinstalado. Se descarga bajo demanda mediante EnsureReadyAsync Windows Update. Las aplicaciones deben comprobar GetReadyState y mostrar un cuadro de diálogo de consentimiento antes de desencadenar la descarga. Los usuarios pueden administrar el modelo en Configuración > Componentes de IA del sistema > .

Para obtener directrices sobre IA responsable, consulte la nueva Nota de transparencia: API de modelos de lenguaje en equipos PC sin Copilot+.

Las nuevas API de reconocimiento de voz en el dispositivo en Microsoft.Windows.AI.Speech habilitan la conversión de voz a texto por lotes y en streaming. BatchRecognition reconoce una fuente de audio completa en una sola llamada y genera los eventos StreamingRecognition y Recognizing. El audio puede provenir de un dispositivo (AudioConfiguration.FromAudioDevice), un archivo (FromFile), un flujo de entrada (FromStream) o ser enviado por el llamador a través de SpeechAudioProvider (PCM de 16 kHz, 16 bits y un solo canal). El modelo en el dispositivo se administra a través de SpeechRecognitionModel.EnsureReadyAsync / TryCreateAsync, y se informa del progreso de la descarga y la carga a través de SpeechRecognitionModelProgress.

Una nueva enumeración Microsoft.Windows.Workloads.NpuType muestra la clase NPU en el dispositivo actual (por ejemplo, Qnn, Lnl, Stx, Win365, Unknown, None), por lo que la infraestructura de aplicaciones y cargas de trabajo puede enrutar las cargas de trabajo de IA a la ruta de acceso de ejecución adecuada.

Esta versión incluye las siguientes API nuevas en comparación con la versión 2.1 Experimental 8 :

Microsoft.UI.Xaml

    Setter
        ValueProperty

Microsoft.UI.Xaml.Markup

    XamlBindingHelper
        SetPropertyFromColor
        SetPropertyFromCornerRadius
        SetPropertyFromThickness

Microsoft.Windows.AI.Speech

    AudioConfiguration
    BatchRecognition
    SpeechAudioProvider
    SpeechContract
    SpeechRecognitionModel
    SpeechRecognitionModelProgress
    SpeechRecognitionModelProgressStatus
    SpeechRecognitionModelResult
    StreamingRecognition
    StreamingRecognizedEventArgs
    StreamingRecognizingEventArgs

Microsoft.Windows.AI.Text.Experimental

    LanguageModelExperimental
        CompressPromptAsync
        GenerateResponseAsync
        GenerateResponseFromEmbeddingsAsync

    LanguageModelOptionsExperimental
        PreferredRetentionRatio

Microsoft.Windows.Workloads

    NpuType

LanguageModelExperimental.GenerateStructuredJsonResponseAsync(introducido en 2.0 Experimental 7) ahora devuelve un tipo dedicado con una GenerateStructuredJsonResponseResult propiedad, en lugar del par genéricoGenerateStructuredJsonResponseStatusLanguageModelResponseResult / .LanguageModelResponseStatus La nueva enumeración de estado es específica de la generación restringida por esquemas: incluye un ResponseInvalidJson valor para el caso en el que la salida del modelo no cumplió el esquema JSON solicitado, independiente de los errores de respuesta genéricos del modelo de lenguaje.

Como parte de esta división, el ResponseInvalidJson valor se ha quitado de la enumeración estable LanguageModelResponseStatus (donde se había agregado anteriormente para admitir la salida JSON estructurada). Las aplicaciones que gestionaban ResponseInvalidJson desde LanguageModelResponseStatus deben trasladar esa gestión al nuevo GenerateStructuredJsonResponseStatus que devuelve GenerateStructuredJsonResponseAsync. Quienes llaman a LanguageModelResponseStatus ya no necesitan considerar un valor de error específico de JSON.

Esta versión incluye las siguientes API nuevas en comparación con la versión 2.0 Experimental 7 :

Microsoft.UI.Xaml.Controls

    TitleBar
        AutoRefreshDragRegions
        AutoRefreshDragRegionsProperty
        GetIsDragRegion
        IsDragRegionProperty
        RecomputeDragRegions
        SetIsDragRegion

Microsoft.Windows.AI

    AICapabilities

    AICapabilityCategory

Microsoft.Windows.AI.Text

    LanguageModelLowRankAdapter

    LanguageModelLowRankAdapterResult

    LanguageModelOptions
        LowRankAdapter

    LanguageModelResponseStatus
        IncompatibleLowRankAdapter

Microsoft.Windows.AI.Text.Experimental

    GenerateStructuredJsonResponseResult

    GenerateStructuredJsonResponseStatus

    LanguageModelOptionsExperimental
        LowRankAdapter [Experimental]

SDK de Aplicaciones para Windows 2.0.0-experimental7 introduce compatibilidad experimental con CMake (en desarrollo activo), lo que permite a los desarrolladores de C++ consumir paquetes NuGet de SDK de Aplicaciones para Windows en proyectos basados en CMake.

La integración de CMake se basa en NuGetCMakePackage, un módulo CMake de código abierto que puentea la brecha entre la administración de paquetes NuGet y el flujo de trabajo nativo find_package() de CMake. NuGetCMakePackage controla la descarga y restauración de paquetes NuGet en tiempo de configuración a través de add_nuget_packages(), verifica cada paquete para una configuración de CMake incrustada en el build/cmake/<package>-config.cmake, y expone los encabezados del paquete, las bibliotecas de importación, las DLL en tiempo de ejecución y los metadatos de WinRT como objetivos estándar de CMake.

Cada componente del SDK de Aplicaciones para Windows y paquete dependiente de NuGet ahora incorpora un archivo de configuración de CMake en build/cmake/, que con la ayuda de la biblioteca NuGetCMakePackage, permite que find_package() de CMake descubra automáticamente destinos, encabezados, bibliotecas y DLL en tiempo de ejecución sin necesidad de configurar rutas manualmente. Esto abarca todos los paquetes de componentes, incluidos Foundation, InteractiveExperiences, DWrite, Widgets, AI, ML y WinUI, así como dependencias como Base y Runtime.

Para obtener información general sobre el modelo de consumo de CMake e instrucciones de introducción, consulte la página de aterrizaje de CMake.

Esta característica es experimental y se está implementando de forma anticipada para recopilar comentarios de la comunidad. Las convenciones de nomenclatura de destino y los patrones de configuración están sujetos a cambios en función de la entrada del desarrollador. Dado que se trata de un vuelo anticipado, hay alguna ceremonia y configuración implicada: consulte las aplicaciones de ejemplo de CMake que ilustran la configuración y el uso de un extremo a otro en los cuatro escenarios de implementación (SelfContained|FrameworkDependent x Packaged|Unpackaged).

Queremos saber de usted. Si encuentra un escenario que no está cubierto actualmente, tiene sugerencias para mejorar la experiencia del desarrollador o tiene problemas, envíe comentarios en la pestaña Issues en el repositorio de código abierto SDK de Aplicaciones para Windows o inicie una conversación en Discussions. Su aportación dará forma directamente al desarrollo activo de esta funcionalidad.

Esta versión experimental acumula los cambios y correcciones enviadas en 2.0-Preview1 y 2.0-Preview2. A continuación se resumen los elementos presentados; consulte las notas de la versión preliminar vinculadas para obtener información completa.

Desde la versión 2.0-Preview1:

• Windows ML: se ha corregido que RegisterCertifiedAsync devuelva correctamente cero proveedores de ejecución cuando se llama de nuevo en el mismo proceso.
• Microsoft.UI.Content: nueva propiedad InputFocusController.ShouldShowKeyboardCues y nueva API de conveniencia PointerPoint.GetCurrentPoint.
• Microsoft.Windows.Management.Deployment: nuevas API de PackageVolume para hacer paridad con Windows.Management.Deployment (incluido AddAsync, GetDefault, GetAvailableSpaceAsync, IsAppxInstallSupported, IsOffline, IsFeatureSupported, etc.). Nuevo IPackageValidator punto de extensibilidad en AddPackageOptions y StagePackageOptions, con tres validadores integrados: PackageCertificateEkuValidator, PackageFamilyNameValidatory PackageMinimumVersionValidator.
• Microsoft.Windows. Storage.Pickers:
  • Nuevas Title propiedades en FileOpenPicker, FileSavePicker y FolderPicker, habilitando títulos de diálogo personalizados.
  • Nuevas SettingsIdentifier propiedades en FileOpenPicker, FileSavePicker y FolderPicker, habilitando el estado específico de la instancia del selector entre sesiones.
  • Nuevas InitialFileTypeIndex propiedades en FileOpenPicker y FileSavePicker, lo que permite a los desarrolladores establecer el filtro de tipo de archivo seleccionado predeterminado por índice (basado en 0).
  • Nueva propiedad ShowOverwritePrompt de FileSavePicker. El valor predeterminado es true y controla si el selector muestra una advertencia sobre la sobrescritura cuando el usuario elige un archivo existente a través de FileSavePicker.
  • Se cambió el comportamiento predeterminado de FileSavePicker: a partir de WindowsAppSDK 2.0, FileSavePicker ya no creará un archivo vacío cuando el usuario elija un archivo no existente, permitiendo a los desarrolladores decidir cuándo crear el archivo.
  • Nuevo PickMultipleFoldersAsync método en FolderPicker, habilitando la selección de varias carpetas en una sola operación.
• Correcciones de errores: informes de progreso del instalador; se ha mejorado el control de errores para WindowsAppSDKSelfContained las bibliotecas de clases.

Desde la versión 2.0-Preview2:

• API de IA de Windows: las API de Phi Silica se aplican como una característica de acceso limitado; los nuevos valores de AIFeatureReadyState exponen problemas de adquisición de modelos, como funcionalidades que faltan, hardware incompatible y actualizaciones de sistema operativo necesarias; los errores de instalación de red/Windows Update persistentes ahora están marcados; se ha mejorado la capacidad de diagnóstico de las API de Text Intelligence.
• Condicionales XAML personalizados: IXamlCondition se gradúa y cambia el nombre de la interfaz experimental IXamlPredicate, permitiendo las condiciones personalizadas evaluadas en tiempo de análisis XAML.
• WebView2 (WinUI 3): compatibilidad con el arrastre para el contenido hospedado en WebView2 (texto, HTML, imágenes, direcciones URL), cancelación de arrastre, objetos visuales de arrastre personalizados y datos de arrastre personalizables. Requiere WebView2 Runtime 144.0.3719.11 o posterior. (DownloadURL todavía no se admite).
• Correcciones de errores: Advertencias de compilación MSB8027/LNK4042 debido a elementos ClCompile duplicados en archivos .targets (con una solución alternativa de exclusión WindowsAppSDK_Arm64EcCompilerWorkaround para ARM64EC+LTCG); bloqueo de ListView durante la navegación por teclado después de las actualizaciones de la lista de elementos; bloqueo de WinUI 3 cuando el foco se desplaza a un CoreWebView2Controller no visible.

• Pase de cambio de nombre de API para mayor claridad y coherencia:
  • ScaleFrameStatus → VideoScalerStatus
  • VideoScalerOptions.RegionOfInterests → VideoScalerOptions.RegionsOfInterest
  • VideoScaler.ScaleFrame → VideoScaler.Scale y VideoScaler.ScaleImageBuffer
• Varias correcciones de errores y mejoras de calidad en VSR.

• Nueva API de LanguageModelExperimental.GenerateStructuredJsonResponseAsync en Microsoft.Windows.AI.Text.Experimental para generar una salida JSON estructurada a partir de un modelo de lenguaje.
• Nuevo LanguageModelResponseStatus.ResponseInvalidJson valor de estado para indicar que un modelo devolvió una respuesta que no se interpretó como JSON válido.

• Nuevas API de AppContentIndexer.GetExistingIndexes y AppContentIndexer.IsContentKindSupported.
• Nuevo AppManagedOcrTextQueryMatch tipo y QueryMatchContentKind.AppManagedOcrText valor para facilitar la consulta de contenido de la aplicación a través del texto derivado de OCR.
• Nueva GetOrCreateIndexOptions.CreateAlways para forzar la creación de un índice nuevo.
• Nuevas ContentItemErrorDetail.InsufficientDiskSpace para mostrar fallos de espacio en disco bajo durante la indexación.

Esta versión incluye las siguientes API experimentales nuevas y modificadas en comparación con 2.0.0-experimental6:

Microsoft.UI.Input

    InputFocusController
        ShouldShowKeyboardCues

    PointerPoint
        GetCurrentPoint

Microsoft.UI.Xaml.Markup

    IXamlCondition

Microsoft.Windows.AI

    AIFeatureReadyResult
        PackageInstallationFailed

    AIFeatureReadyState
        CapabilityMissing
        NotCompatibleWithSystemHardware
        OSUpdateNeeded

Microsoft.Windows.AI.Text

    LanguageModelResponseStatus
        ResponseInvalidJson

Microsoft.Windows.AI.Text.Experimental

    LanguageModelExperimental
        GenerateStructuredJsonResponseAsync

Microsoft.Windows.AI.Video

    VideoScaler
        Scale
        ScaleImageBuffer

    VideoScalerOptions
        RegionsOfInterest

    VideoScalerStatus

Microsoft.Windows.Management.Deployment

    AddPackageOptions
        GetValidationEventSourceForUri
        IsPackageValidationSupported
        PackageValidators

    IPackageValidator
    PackageCertificateEkuValidator
    PackageFamilyNameValidator
    PackageMinimumVersionValidator
    PackageValidationEventArgs
    PackageValidationEventSource
    PackageValidationHandler
    PackageVolume
        AddAsync
        GetAvailableSpaceAsync
        GetDefault
        GetPackageVolumeByName
        GetPackageVolumeByPath
        IsFeatureSupported
        IsOffline
        RemoveAsync
        SetDefault
        SetOfflineAsync
        SetOnlineAsync

    PackageVolumeFeature
    StagePackageOptions
        GetValidationEventSourceForUri
        IsPackageValidationSupported
        PackageValidators

Microsoft.Windows.Search.AppContentIndex

    AppContentIndexer
        GetExistingIndexes
        IsContentKindSupported

    AppManagedOcrTextQueryMatch
    ContentItemErrorDetail
        InsufficientDiskSpace

    GetOrCreateIndexOptions
        CreateAlways

    QueryMatchContentKind
        AppManagedOcrText

Microsoft.Windows.Storage.Pickers

    FileOpenPicker
        InitialFileTypeIndex
        SettingsIdentifier
        Title

    FileSavePicker
        InitialFileTypeIndex
        SettingsIdentifier
        ShowOverwritePrompt
        Title

    FolderPicker
        PickMultipleFoldersAsync
        SettingsIdentifier
        Title

Windows ML ahora se puede usar desde proyectos de C++ mediante CMake. Consulte la página Introducción para obtener más información.

La versión de ONNX Runtime se ha actualizado a la versión 1.24.2. Consulte Versiones de ONNX Runtime para obtener más información.

• NPUPowerMode ha quedado en desuso en favor de las API de administración de energía más recientes.
• GetReadyState ahora devuelve NotSupported de forma elegante cuando el agente de sesión no está disponible, en lugar de lanzar una excepción.

• Se ha agregado compatibilidad con el formato de salida NV12 para Video Super Resolution.

• Confiabilidad mejorada DeleteIndex . A veces DeleteIndex fallaría con ERROR_SHARING_VIOLATION.

• Corrección para cuadros de límite de OCR que devuelven valores negativos en algunos casos extremos.

• La búsqueda de contenido de la aplicación forma parte de un paquete de Microsoft.Windows.Search independiente en lugar de formar parte de Microsoft.Windows.AI package.

• Corrección para la búsqueda de prefijos que no funcionan con cadenas de consulta cortas.

• Nuevas API y cambios de nombre basados en la revisión oficial de la API.

  • IndexadorDeContenidoDeApp
    • ObtenerElementosDeContenidoQueRequierenReindexación
    • Remove -> EliminarElementoDeContenido
    • RemoveMultiple:> RemoveContentItems
    • EliminarTodosLosElementosDeContenido
    • GetContentIndexingStatus-> GetContentItemStatus
    • GetMultipleContentIndexingStatus -> GetContentItemStatuses
    • ObtenerElementosDeContenido
  • AppCOntentIndexListener
    • EstadoDeIndexaciónCambiado:> EstadoDeElementoDeContenidoCambiado
  • AppIndexTextQuerySession
    • UpdateQuery:> UpdateQueryPhrase
    • ResultadoMásReciente-> ObtenerResultado
    • MostRecentResultChanged -> ResultChanged
  • AppIndexImageQuerySession
    • UpdateQuery:> UpdateQueryPhrase
    • ResultadoMásReciente-> ObtenerResultado
    • MostRecentResultChanged -> ResultChanged
  • AppManagedImageQueryMatch
    • Subregión-> RegiónDeInterés
  • ResultadoDeEstadoDelElementoDeContenido
    • Estado de Reindexación * Estado de Reindexación de Elementos de Contenido
  • TextQuerySessionResult
    • IsValid
  • ImageQuerySessionResult
    • IsValid
  • QueryContentItemsFilterFlags

• Se corrigió el fallo de ImageDescription.DescribeAsync con InternalError debido a una condición de carrera.

Esta versión incluye las siguientes API experimentales nuevas y modificadas en comparación con 2.0.0-experimental5:

Microsoft.Windows.Search.AppContentIndex

    AppContentIndexer
        GetContentItems
        GetContentItemStatus
        GetContentItemStatuses
        RemoveAllContentItems
        RemoveContentItem
        RemoveContentItems

    AppContentIndexListener
        ContentItemStatusChanged

    AppManagedImageQueryMatch
    ContentItemErrorDetail
        IndexCorruption

    ContentItemReindexingStatus
        Unspecified

    QueryContentItemsFilterFlags

• Contrato de licencia simplificado con términos más claros para los ISV que crean aplicaciones con Windows ML.
• Secciones reestructuradas que abarcan la instalación, los datos y el código distribuible con mayor claridad.
• La sección Nuevo aviso de cumplimiento del proveedor de ejecución (EP) aclara las responsabilidades del desarrollador con respecto a los proveedores de ejecución acelerados por hardware.
• Vínculos directos a contratos de licencia de proveedor para NVIDIA TensorRT, Intel OpenVINO y Qualcomm QNN (SDK de red neuronal de Qualcomm).

• Las compilaciones experimentales de Windows ML están alineadas con la versión principal 1.24 de ONNX Runtime para mejorar la compatibilidad y la estabilidad.
• Se aplican proveedores de ejecución estables de interfaz binaria de aplicaciones (ABI) para garantizar un comportamiento predecible entre dispositivos, con proveedores de ejecución no estables excluidos de la adquisición.
  • Solo se admite el proveedor de ejecución de OpenVINO, con proveedores de ejecución adicionales que se van a agregar a lo largo del tiempo a medida que cumplen los requisitos de estabilidad.
• El tamaño de Microsoft.Windows.AI.MachineLearning.dll se redujo aproximadamente 160 KB.

• Nuevas API experimentales para buscar estadísticas de elementos que se indexan. Esto proporciona visibilidad sobre lo que sucede en el índice.
• Compatibilidad con la cancelación de consultas para permitir que las aplicaciones ejecuten una consulta y actualícela si hay una nueva consulta antes de que se complete la actual. Esto permite responder más rápido a la consulta mientras un usuario escribe en la cadena de búsqueda.
• Compatibilidad con la coincidencia de prefijos con cadenas cortas para mejorar los resultados a medida que el usuario escribe.

• VideoScaler ahora es descartable, lo que mejora la administración de recursos y el control del ciclo de vida.
• El modelo de VSR ahora está compilado y almacenado en caché para mejorar el rendimiento y reducir los costos de inicialización repetidos.
• Se ha agregado una comprobación de funcionalidad para validar la compatibilidad con VSR antes de usarla.
• La inicialización explícita de WinML ya no es necesaria cuando se usa Video Super Resolution.

• El FlowLayout control usa ahora la terminología itemSpacing y LineSpacing en lugar de propiedades de espaciado horizontal y vertical. La nomenclatura alineada mejora la claridad y la coherencia con los patrones de diseño modernos en los marcos de interfaz de usuario.

• El WrapPanel control ahora usa la nomenclatura ItemSpacing y LineSpacing en lugar de las propiedades de espaciado horizontal y vertical anteriores.

• Implementó la interfaz IXamlPredicate para definir predicados personalizados que se integran perfectamente con la sintaxis del espacio de nombres condicional de XAML y se evalúan en tiempo de análisis XAML.
• Los predicados personalizados permiten escenarios XAML condicionales basados en factores específicos de la aplicación, como:
  • Marcas de características
  • Funcionalidades del dispositivo
  • Lógica de negocios
  • Parámetros de configuración
  • Otras condiciones en tiempo de ejecución

• Se han actualizado los paquetes para habilitar la facilidad de uso externa, lo que incluye cambios en:
  • Microsoft.UI.DCPP.Dependencies.Minimal
  • Microsoft. Interfaz de usuario. DCPP. Dependencies.Edge
  • ExpPointerPointStatics
• Se ha agregado compatibilidad de compilación para Visual Studio 2026
• Se han introducido herramientas y scripts para que los desarrolladores externos puedan compilar y probar WinUI.

• [en desuso] DependencyObject.Dispatcher
• [en desuso] Window.Current
• [en desuso] FocusManager.GetFocusedElement
• Se ha cambiado el nombre de SystemBackdropHost a SystemBackdropElement

• [renamed] Microsoft.Windows.AI.Search.Experimental.AppContentIndex a Microsoft.Windows.Search.AppContentIndex

• Se han corregido los errores de "Clase no registrada" al utilizar implementación autónoma con Windows ML. Los desarrolladores que usan la implementación autocontenida ya no necesitan registrar todas las clases activables del paquete Foundation que se usaron internamente.
• Se ha corregido un posible fallo que ocurre durante el apagado del proceso al usar Windows ML.
• Se ha corregido la ruta de enrutamiento de API ImageForegroundExtractor para que las llamadas lleguen al punto de conexión correcto.
• Asegurar que el progreso de instalación y descarga del proveedor de ejecución se reenvía correctamente a las aplicaciones durante la implementación del paquete.
• Se ha corregido un bloqueo en SystemBackdrop cuando el destino se desconecta, al proteger las rutas de desconexión no válidas.
• Se ha corregido un problema que impedía que las API de IA Windows estuvieran disponibles para algunas aplicaciones.

Esta versión incluye las siguientes API experimentales nuevas y modificadas en comparación con 2.0.0-experimental3:

Microsoft.UI.Content

    ChildSiteLink
        IsHitTestVisible

Microsoft.UI.Xaml.Controls

    FlowLayout
        LineSpacing
        LineSpacingProperty
        MinItemSpacing
        MinItemSpacingProperty

    SystemBackdropElement
    WrapPanel
        ItemSpacing
        ItemSpacingProperty
        ItemsStretch
        ItemsStretchProperty
        LineSpacing
        LineSpacingProperty

    WrapPanelItemsStretch

Microsoft.UI.Xaml.Markup

    IXamlPredicate

Microsoft.Windows.AI.Video

    VideoScaler
        Dispose

Microsoft.Windows.Search.AppContentIndex

    AppContentIndexContract
    AppContentIndexer
    AppContentIndexListener
    AppIndexContentRegion
    AppIndexImageQuery
    AppIndexImageQuerySession
    AppIndexQueryMatch
    AppIndexTextQuery
    AppIndexTextQuerySession
    AppIndexTextStreamEncoding
    AppManagedImageQueryMatch
    AppManagedIndexableAppContent
    AppManagedTextQueryMatch
    ContentItemErrorDetail
    ContentItemReader
    ContentItemReindexingStatus
    ContentItemStatus
    ContentItemStatusResult
    ContentRegionTextOptions
    DeleteIndexResult
    DeleteIndexStatus
    DeleteIndexWhileInUseBehavior
    GetOrCreateIndexOptions
    GetOrCreateIndexResult
    GetOrCreateIndexStatus
    ImageQueryMatch
    ImageQueryOptions
    ImageQuerySessionResult
    IndexableAppContent
    IndexCapabilities
    IndexCapabilitiesOfCurrentSystem
    IndexCapability
    IndexCapabilityInitializationStatus
    IndexCapabilityLanguageStatus
    IndexCapabilityOfCurrentSystemStatus
    IndexCapabilityRequirement
    IndexCapabilityState
    IndexStatistics
    QueryMatchContentKind
    QueryMatchScope
    RegionContentKind
    TextLexicalMatchType
    TextQueryMatch
    TextQueryOptions
    TextQuerySessionResult

• Una regresión del tiempo de ejecución de ONNX hace que la superresolución de video falle en los dispositivos Qualcomm. Una actualización pendiente al proveedor de ejecución de NPU de Qualcomm resuelve este problema.

El nuevo control experimental SplitMenuFlyoutItem está diseñado para proporcionar una experiencia de botón dividido dentro de un menú desplegable. Este control permitirá a los desarrolladores exponer una acción principal predeterminada, al tiempo que ofrece opciones adicionales a través de un submenú, ideal para condensar la funcionalidad compleja en una superficie más pequeña y ahorrar la longitud general del menú.

Junto con las funcionalidades de MenuFlyoutItem y MenuFlyoutSubItem, el control incluye otras dos propiedades: SubMenuPresenterStyle y SubMenuItemStyle, que permite la personalización del submenú, como usar GridView para el moderador del submenú.

    <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>

Tipos renombrados

• Cambio de nombre de WinMLCatalogModel a ModelCatalog
• Cambio de nombre de CatalogModelSource a ModelCatalogSource

Actualizaciones de métodos

• CatalogModelInfo: Se ha renombrado GetInstance a GetInstanceAsync
• ModelCatalogSource: Se ha renombrado CreateFromUri a CreateFromUriAsync
• ModelCatalog: Se ha renombrado FindModel a FindModelAsync
• ModelCatalog: Se ha renombrado FindAllModels a FindAllModelsAsync

Cambios de propiedad

• Actualizado CatalogModelInfo.Size a CatalogModelInfo.ModelSizeInBytes

Actualizaciones de comportamiento

• Recupere la instancia de CatalogModelInstanceResult mediante . GetInstance()
• CatalogModelStatus ahora devuelve Ready o NotReady en función de la disponibilidad local.
• Se ha agregado CatalogModelInstanceStatus a un estado de instancia independiente del estado del modelo

Mejoras de CatalogModelInfo

• Cambio de nombre de Alias a Name
• Cambio de nombre de Revision a Version
• Se ha agregado Publisher
• Eliminado DisplayName

Cambios de JSON

• Se ha cambiado el alias nombre a id.
• Se ha quitado modelType y description.
• Se ha cambiado el executionProvider nombre a executionProviders.
• Se ha actualizado executionProviders para que sea una matriz de objetos JSON en lugar de una lista separada por comas.

Cambios adicionales

• ModelCatalog ahora devuelve una lista de proveedores de ejecución (EPs) cuando se crea una instancia.
• Se ha agregado compatibilidad con Windows 10 (1809) y versiones posteriores.
• Se ha agregado compatibilidad con archivos locales, incluidos los archivos normales y los paquetes MSIX.
• Se han corregido bloqueos causados por el JSON de catálogo no válido.

• El tipo anterior AppIndexQuery , que incluía GetNextTextMatches y GetNextImageMatches los métodos, se ha dividido en dos tipos distintos: AppIndexTextQuery y AppIndexImageQuery. El AppContentIndexer.CreateQuery método se ha reemplazado por: CreateTextQuery y CreateImageQuery.

• Estos métodos ahora devuelven AppIndexTextQuery y AppIndexImageQuery respectivamente. Para simplificar el uso, también se han actualizado los tipos de opciones:

  • Quitado: AppIndexQueryOptions, TextMatchOptions y ImageMatchOptions
  • Agregado: TextQueryOptions y ImageQueryOptions

• Las API del AppContentIndex espacio de nombres que devolvieron previamente las matrices ahora devuelven IVectorView para mejorar la coherencia y el rendimiento.

• El AppContentIndexer.WaitForIndexingIdleAsync método se ha actualizado para aceptar un TimeSpan parámetro en lugar de un entero, lo que proporciona un control de tiempo de espera más claro y flexible.

La VideoScaler API ofrece mejoras de vídeo en tiempo real a través del escalado avanzado de inteligencia artificial, optimizado para secuencias con personas en conversación. Permite a los desarrolladores proporcionar visuales más nítidos y claros en las plataformas de videoconferencia, streaming y edición, incluso en condiciones de red deficientes. La API admite la personalización de la resolución de salida, la velocidad de fotogramas y las regiones de interés, con compatibilidad con varios formatos de vídeo, incluidos BGR, RGB y NV12.

La nueva API RewriteCustomAsync le permite proporcionar una cadena de entrada que guía PhiLice en la reescritura de texto seleccionado. Puede experimentar con nuevos estilos creativos como "Goofy" o "Pirate" para transformar al instante el contenido.

La ImageGenerator clase aprovecha los modelos de difusión estable para proporcionar funcionalidades eficaces de generación de imágenes. Admite varios escenarios de generación:

• Texto a imagen: Genere imágenes a partir de mensajes de texto descriptivos.

• Imagen a imagen: Transformar las imágenes existentes en función de las descripciones de texto.

• Relleno mágico: Rellene las regiones enmascaradas de imágenes con contenido generado por IA.

• Estilo libro de colorear: Generar imágenes de estilo libro de colorear.

• Restilizar: Cambie el estilo artístico de las imágenes existentes mientras conserva la estructura.

Todas las imágenes generadas se devuelven en formato RGB8 a través de objetos ImageBuffer . La API incluye filtros de seguridad de contenido integrados y admite parámetros de generación personalizables.

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");
    }
}

Esta versión incluye las siguientes API experimentales nuevas y modificadas en comparación con 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

• Se ha corregido el cálculo del cuadro de límite cuando se gira el texto. En algunas circunstancias, la coincidencia de texto OCR dentro de las imágenes notificó límites de región inexactos o vacíos cuando se giraba el texto.

Las API de AppContentIndexer permiten a los desarrolladores indexar de forma eficaz el contenido de la aplicación, incluidos texto e imágenes para una recuperación rápida y relevante. Admitir búsquedas léxicas (basadas en palabras clave) y semánticas (basadas en significados), estas API permiten a las aplicaciones ofrecer resultados rápidos y relevantes en función de la intención y el contexto del usuario en lugar de simplemente palabras clave exactas.

Esta funcionalidad desbloquea los siguientes escenarios avanzados:

• Búsqueda semántica
  Las aplicaciones pueden devolver resultados en función de la intención y el significado en lugar de coincidencias exactas de palabras clave.
  Ejemplo: Una consulta para "escala de tiempo del proyecto" puede exponer contenido que mencione "programación" o "fechas de entrega", incluso si esas palabras exactas no se usaron.
• Generación Aumentada por Recuperación (RAG)
  El contenido indizado puede servir como base de conocimiento para los modelos de IA generativas. Cuando un usuario hace una pregunta, la aplicación recupera los documentos o fragmentos más relevantes de su índice y los alimenta en el modelo, lo que permite respuestas precisas y compatibles con el contexto basadas en datos reales.

Las API del catálogo de modelos de ML de Windows permiten que la aplicación o la biblioteca detecten y descarguen dinámicamente archivos de modelos de IA de gran tamaño desde sus propios catálogos de modelos en línea, lo que elimina la necesidad de empaquetar estos archivos grandes directamente con la aplicación o biblioteca. El catálogo de modelos ayuda a garantizar la compatibilidad del dispositivo filtrando modelos y descargando solo los aplicables al dispositivo de Windows específico en uso.

La actualización más reciente Microsoft.Windows.Storage.Pickers simplifica la selección de archivos y carpetas al permitir que los desarrolladores establezcan ubicaciones de carpetas iniciales y persistentes, y mediante la agrupación de filtros de tipo de archivo con etiquetas claras para facilitar la navegación.

La PopupAnchor API ahora permite que DesktopPopupSiteBridge admita el posicionamiento relativo anclándose a su ventana o isla propietaria, resolviendo la limitación donde las ventanas emergentes solo podían ubicarse absolutamente mediante coordenadas de pantalla.

La InputUnderlyingWindowController API permite a los desarrolladores designar el HWND de destino para recibir mensajes de entrada que originalmente se enviaron a un ContentIsland creado a partir de un SystemVisual (consulte ContentIsland.CreateForSystemVisual).

SystemBackdropHost permite colocar un telón de fondo del sistema (acrílico/mica) en cualquier lugar dentro del árbol visual de una aplicación.

El WrapPanel es un panel de diseño XAML de WinUI que organiza los elementos secundarios en una posición secuencial de izquierda a derecha, los elementos que desbordan la línea pasarán automáticamente a la línea siguiente al final del panel contenedor. Resulta útil para diseños dinámicos.

Se trata de un puerto del control Windows Community Toolkit existente.

Esta versión incluye las siguientes API experimentales nuevas y modificadas en comparación con 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 Se debe llamar a las API desde un subproceso en segundo plano. Usarlo en el subproceso de la interfaz de usuario puede bloquearse o provocar pausas largas que afectan a la experiencia del usuario.
• Los resultados de la consulta que usan AppIndexQuery.GetNextTextMatches y AppIndexQuery.GetNextImageMatches serán NULL cuando no haya coincidencias en lugar de una lista vacía.
• Las coincidencias de imagen utilizando AppManagedImageQueryMatch.Subregion basadas en los valores del OCR pueden ser ocasionalmente inexactas, especialmente cuando el texto está girado o inclinado.
• Las coincidencias de imagen que usan AppManagedImageQueryMatch.Subregion pueden incluir a veces rectángulos de tamaño cero o extremadamente pequeños, lo que conduce a resultados inexactos.
• Una consulta vacía de AppContentIndex.CreateQuery puede producir una excepción.

Las API de catálogo de modelos de Windows ML permiten a la aplicación o biblioteca descargar dinámicamente archivos de modelo de IA de gran tamaño desde sus propios catálogos de modelos en línea sin enviar esos archivos grandes directamente con la aplicación o biblioteca. Además, el catálogo de modelos ayudará a filtrar qué modelos son compatibles con el dispositivo Windows en el que se ejecuta, de modo que el modelo adecuado se descargue en el dispositivo.

Ventajas clave:

• Agregar catálogos: agregar uno o varios catálogos en línea
• Detectar modelos compatibles: busque automáticamente los modelos que funcionan con los proveedores de hardware y ejecución del usuario.
• Descargar modelos: descargar y almacenar modelos de varios orígenes
• Compartir modelos entre aplicaciones: si varias aplicaciones usan el mismo origen de catálogo, los modelos se compartirán en el disco sin duplicar las descargas.

• Se ha corregido un problema en DeploymentManager que provocaba que notificara incorrectamente PackageInstallRequired en algunos casos.

Esta versión incluye las siguientes API experimentales nuevas y modificadas:

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