Заметки о выпуске пакета SDK для приложений Windows 2.0

• Версия среды выполнения ONNX в Windows ML обновлена до версии 1.24 RC
• Исправлена ошибка, из-за которой при повторном вызове RegisterCertifiedAsync в том же процессе он неправильно возвращает 0 поставщиков выполнения (EP)

• Новое InputFocusController.ShouldShowKeyboardCues свойство для того чтобы помочь разработчикам решить, нужно ли отображать подсказки клавиатуры сразу после создания ContentIsland.
• Новый удобный API PointerPoint.GetCurrentPoint, который позволяет разработчикам извлекать активные данные PointerPoint из предоставляемых pointerId.

• Надежность DeleteIndex улучшена. Иногда DeleteIndex давал сбой с ошибкой ERROR_SHARING_VIOLATION.

• Исправление для ограничивающих полей OCR, возвращающих отрицательные значения в некоторых пограничных случаях.

• Поиск содержимого приложения является частью отдельного Microsoft.Windows.Search пакета вместо того, чтобы быть частью Microsoft.Windows.AI package.

• Исправление для поиска префикса, не работающего с короткими строками запроса.

• Новые API и переименования на основе официальной проверки API.

  • индексатор содержимого приложений (AppContentIndexer)
    • ПолучитьЭлементыКонтентаТребующиеПереиндексации
    • Удалить —> УдалитьЭлементСодержимого
    • RemoveMultiple —> RemoveContentItems
    • УдалитьВсеЭлементыКонтента
    • GetContentIndexingStatus —> GetContentItemStatus
    • GetMultipleContentIndexingStatus —> GetContentItemStatuses
    • GetContentItems
  • AppContentIndexListener
    • ИзменениеСтатусаИндексации -> ИзменениеСтатусаЭлементаСодержимого
  • AppIndexTextQuerySession
    • UpdateQuery —> UpdateQueryPhrase
    • MostRecentResult —> GetResult
    • MostRecentResultChanged —> ResultChanged
  • AppIndexImageQuerySession
    • UpdateQuery —> UpdateQueryPhrase
    • MostRecentResult —> GetResult
    • MostRecentResultChanged —> ResultChanged
  • AppManagedImageQueryMatch
    • > ОбластьИнтереса
  • РезультатСтатусаЭлементаКонтента
    • СтатусПереиндексирования * СтатусПереиндексированияЭлементаКонтента
  • TextQuerySessionResult
    • IsValid
  • РезультатЗапросаСессииИзображений
    • IsValid
  • QueryContentItemsFilterFlags

• Исправлена проблема, из-за которой установщик WindowsAppSDK не отображал ход выполнения, что создавало впечатление зависания. Теперь установщик предоставляет более четкие отзывы о ходе выполнения.
• Улучшена обработка ошибок сценариев, в которых WindowsAppSDKSelfContained включен для библиотек классов.

Этот выпуск включает следующие новые и измененные экспериментальные API по сравнению с 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

Windows ML теперь можно использовать из проектов C++ с помощью CMake. Дополнительные сведения см. на странице "Начало работы ".

Версия среды выполнения ONNX обновлена до версии 1.24.2. Дополнительные сведения см. в версиях среды выполнения ONNX .

• NPUPowerMode устарел, и вместо него рекомендуется использовать новые API управления питанием.
• GetReadyState теперь аккуратно возвращает NotSupported вместо вызова исключения, если брокер сеансов недоступен.

• Добавлена поддержка выходного формата NV12 для видео с функцией «Video Super Resolution».

• Надежность DeleteIndex улучшена. Иногда DeleteIndex давал сбой с ошибкой ERROR_SHARING_VIOLATION.

• Исправление для ограничивающих полей OCR, возвращающих отрицательные значения в некоторых пограничных случаях.

• Поиск содержимого приложения является частью отдельного Microsoft.Windows.Search пакета вместо того, чтобы быть частью Microsoft.Windows.AI package.

• Исправление для поиска префикса, не работающего с короткими строками запроса.

• Новые API и переименования на основе официальной проверки API.

  • индексатор содержимого приложений (AppContentIndexer)
    • ПолучитьЭлементыКонтентаТребующиеПереиндексации
    • Удалить —> УдалитьЭлементСодержимого
    • RemoveMultiple —> RemoveContentItems
    • УдалитьВсеЭлементыКонтента
    • GetContentIndexingStatus —> GetContentItemStatus
    • GetMultipleContentIndexingStatus —> GetContentItemStatuses
    • GetContentItems
  • AppCOntentIndexListener
    • ИзменениеСтатусаИндексации -> ИзменениеСтатусаЭлементаСодержимого
  • AppIndexTextQuerySession
    • UpdateQuery —> UpdateQueryPhrase
    • MostRecentResult —> GetResult
    • MostRecentResultChanged —> ResultChanged
  • AppIndexImageQuerySession
    • UpdateQuery —> UpdateQueryPhrase
    • MostRecentResult —> GetResult
    • MostRecentResultChanged —> ResultChanged
  • AppManagedImageQueryMatch
    • > ОбластьИнтереса
  • РезультатСтатусаЭлементаКонтента
    • СтатусПереиндексирования * СтатусПереиндексированияЭлементаКонтента
  • TextQuerySessionResult
    • IsValid
  • РезультатЗапросаСессииИзображений
    • IsValid
  • QueryContentItemsFilterFlags

• Исправлен сбой ImageDescription.DescribeAsyncInternalError из-за состояния гонки.

Этот выпуск включает следующие новые и измененные экспериментальные API по сравнению с 2.0.0-experimental5:

Microsoft.Windows.Search.AppContentIndex

    AppContentIndexer
        GetContentItems
        GetContentItemStatus
        GetContentItemStatuses
        RemoveAllContentItems
        RemoveContentItem
        RemoveContentItems

    AppContentIndexListener
        ContentItemStatusChanged

    AppManagedImageQueryMatch
    ContentItemErrorDetail
        IndexCorruption

    ContentItemReindexingStatus
        Unspecified

    QueryContentItemsFilterFlags

• Упрощенное лицензионное соглашение с более четкими условиями для независимых поставщиков программных решений, создающих приложения для Windows ML.
• Реструктурированные разделы, охватывающие установку, данные и распространяемый код с повышенной ясностью.
• Новый раздел уведомления о соответствии поставщиков выполнения (EP) определяет обязанности разработчика относительно поставщиков аппаратного ускорения выполнения.
• Прямые ссылки на соглашения о лицензии поставщика для NVIDIA TensorRT, Intel OpenVINO и Qualcomm QNN (пакет SDK для нейронной сети Qualcomm).

• Экспериментальные сборки Windows ML соответствуют основной строке среды выполнения ONNX версии 1.24 для повышения совместимости и стабильности.
• Поставщики стабильного интерфейса бинарного приложения (ABI) используются для обеспечения предсказуемого поведения на различных устройствах, при этом нестабильные поставщики выполнения не включаются в список приобретений.
  • Поддерживается только исполнительный провайдер OpenVINO. Дополнительные исполнительные провайдеры будут добавлены по мере достижения ими требований стабильности.
• Размер Microsoft.Windows.AI.MachineLearning.dll сократился примерно на 160 КБ.

• Новые экспериментальные API для поиска статистики индексируемых объектов. Это обеспечивает видимость того, что происходит в индексе.
• Поддержка отмены запроса, чтобы разрешить приложениям запускать запрос и обновлять его, если есть новый запрос до завершения текущего. Это позволяет быстрее отвечать на запрос по мере ввода пользователем строки запроса.
• Поддержка сопоставления префиксов для коротких строк для улучшения результатов по мере ввода пользователем.

• VideoScaler теперь является одноразовым, улучшая управление ресурсами и жизненным циклом.
• Модель VSR теперь компилируется и кэшируется для повышения производительности и снижения затрат на повторную инициализацию.
• Добавлена проверка возможностей для проверки поддержки VSR перед использованием.
• Явная инициализация WinML больше не требуется при использовании Видео Super Resolution.

• Теперь элемент FlowLayout управления использует терминологию ItemSpacing и LineSpacing вместо горизонтальных и вертикальных интервалов. Согласованное именование улучшает ясность и согласованность с современными шаблонами макетов во фреймворках пользовательского интерфейса.

• Теперь элемент WrapPanel управления использует номенклатуру ItemSpacing и LineSpacing вместо предыдущих горизонтальных и вертикальных интервалов.

• IXamlPredicate Реализован интерфейс для определения пользовательских предикатов, которые легко интегрируются с синтаксисом условного пространства имен XAML и оцениваются во время синтаксического анализа XAML.
• Пользовательские предикаты позволяют выполнять условные сценарии XAML на основе таких факторов, как:
  • Флаги функций
  • Возможности устройства
  • Бизнес-логика
  • Параметры конфигурации
  • Другие условия выполнения

• Обновленные пакеты для улучшения внешней удобопользовательности, включающие изменения в:
  • Microsoft.UI.DCPP.Dependencies.Minimal
  • Microsoft.UI.DCPP.Dependencies.Edge
  • ExpPointerPointStatics
• Добавлена поддержка сборки для Visual Studio 2026
• Введены средства и скрипты для использования внешними разработчиками для создания и тестирования WinUI.

• [не рекомендуется] DependencyObject.Dispatcher
• [не рекомендуется] Window.Current
• [устаревший] FocusManager.GetFocusedElement
• [переименовано] SystemBackdropHost в SystemBackdropElement

• [переименовано] Microsoft.Windows.AI.Search.Experimental.AppContentIndex в Microsoft.Windows.Search.AppContentIndex

• Исправлены ошибки "Класс не зарегистрирован" при использовании автономного развертывания с Windows ML. Разработчикам, использующим автономное развертывание, больше не нужно регистрировать все активируемые классы пакета Foundation, которые использовались внутри организации.
• Исправлена потенциальная авария при завершении процесса при использовании Windows ML.
• ImageForegroundExtractor Исправлен путь маршрутизации API, чтобы вызовы достигли правильной конечной точки.
• Убедитесь, что прогресс установки и загрузки провайдера исполнительной среды корректно передаётся в приложения во время развертывания пакета.
• Исправлен сбой в SystemBackdrop, когда происходит отключение целевого устройства, путем защиты от недопустимых путей отключения.
• Исправлена проблема, из-за которой AI API Windows не были доступны для некоторых приложений.

Этот выпуск включает следующие новые и измененные экспериментальные API по сравнению с 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

• Регрессия среды выполнения ONNX приводит к несправности функции Video Super Resolution на устройствах Qualcomm. Ожидаемое обновление для поставщика средств выполнения NPU Qualcomm устраняет эту проблему.

Новый, экспериментальный элемент управления SplitMenuFlyoutItem предназначен для предоставления опыта работы с разделенной кнопкой в всплывающем меню. Этот элемент управления позволит разработчикам предоставлять основное действие по умолчанию, а также предлагать дополнительные параметры через подменю, идеально подходит для сокращения сложной функциональности в меньшем объеме и экономии общей длины меню.

Наряду с возможностями MenuFlyoutItem и MenuFlyoutSubItem, элемент управления поставляется с двумя другими свойствами: SubMenuPresenterStyle и SubMenuItemStyle, что позволяет настраивать подменю, например, используя GridView для представления подменю.

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

Переименованные типы

• Переименование WinMLCatalogModel в ModelCatalog
• Переименование CatalogModelSource в ModelCatalogSource

Обновления методов

• CatalogModelInfo: переименовано GetInstance в GetInstanceAsync
• ModelCatalogSource: переименовано CreateFromUri в CreateFromUriAsync
• ModelCatalog: переименовано FindModel в FindModelAsync
• ModelCatalog: переименовано FindAllModels в FindAllModelsAsync

Изменения свойств

• Обновлено CatalogModelInfo.Size до CatalogModelInfo.ModelSizeInBytes

Обновления поведения

• Извлеките экземпляр из CatalogModelInstanceResult, используя .GetInstance().
• CatalogModelStatus теперь возвращает значение Ready или NotReady на основе локальной доступности
• Добавлено CatalogModelInstanceStatus для разделения состояния экземпляра от состояния модели

Обновления CatalogModelInfo

• Переименование Alias в Name
• Переименование Revision в Version
• Добавлено Publisher.
• Удалено DisplayName

Изменения JSON

• Переименовано alias в id.
• Удалены modelType и description.
• Переименовано executionProvider в executionProviders.
• Обновили executionProviders, чтобы он был массивом объектов JSON вместо списка, разделяемого запятыми.

Дополнительные изменения

• ModelCatalog теперь возвращает список поставщиков выполнения (EPS) при создании экземпляра.
• Добавлена поддержка Windows 10 (1809) и более поздних версий.
• Добавлена поддержка локальных файлов, включая как обычные файлы, так и пакеты MSIX.
• Исправлены сбои, вызванные недопустимым JSON каталога.

• Предыдущий AppIndexQuery тип, включающий GetNextTextMatches и GetNextImageMatches методы, был разделен на два разных типа: AppIndexTextQuery и AppIndexImageQuery. Метод AppContentIndexer.CreateQuery был заменен следующим CreateTextQuery : и CreateImageQuery.

• Теперь эти методы возвращаются AppIndexTextQuery и AppIndexImageQuery соответственно. Чтобы упростить использование, типы параметров также были обновлены:

  • Удалено: AppIndexQueryOptionsTextMatchOptions иImageMatchOptions
  • Добавлено: TextQueryOptionsImageQueryOptions

• API в пространстве имен AppContentIndex, которые ранее возвращали массивы, теперь возвращают IVectorView для повышения согласованности и производительности.

• Метод AppContentIndexer.WaitForIndexingIdleAsync был обновлен, чтобы принять TimeSpan параметр вместо целого числа, обеспечивая более четкую и более гибкую обработку времени ожидания.

API VideoScaler обеспечивает усовершенствование видео в режиме реального времени с помощью расширенного масштабирования ИИ, оптимизированного для потоков с участием людей в беседе. Это позволяет разработчикам предоставлять более четкие визуальные элементы для конференц-связи, потоковой передачи и редактирования платформ, даже в условиях плохой сети. API поддерживает настройку разрешения выходных данных, частоты кадров и интересующих регионов с совместимостью для нескольких форматов видео, включая BGR, RGB и NV12.

Новый API RewriteCustomAsync позволяет предоставить входную строку, которая направляет Phi Silica в перезаписи выделенного текста. Вы можете экспериментировать с новыми творческими стилями, такими как Goofy или "Пират", чтобы мгновенно преобразовать содержимое.

Класс ImageGenerator использует стабильные модели диффузии для обеспечения мощных возможностей создания изображений. Система поддерживает несколько сценариев генерации:

• Текст к изображению: Создайте изображения из описательных текстовых запросов.

• Изображение к изображению: Преобразование существующих изображений на основе текстовых описаний.

• Волшебная заливка: Заполните маскированные области изображений с содержимым, созданным ИИ.

• Стиль цветной книги: Создайте цветовые изображения в стиле книги.

• Рестайлинг: Изменение художественного стиля существующих изображений при сохранении структуры.

Все созданные изображения возвращаются в формате RGB8 через объекты ImageBuffer . API включает встроенные фильтры безопасности содержимого и поддерживает настраиваемые параметры создания.

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

Этот выпуск включает следующие новые и измененные экспериментальные API по сравнению с 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

• Исправлено вычисление ограничивающего поля при повороте текста. В некоторых случаях текст OCR, соответствующий изображениям, сообщал о неточных или пустых границах области при повороте текста.

API AppContentIndexer позволяют разработчикам эффективно индексировать содержимое приложения, включая текст и изображения для быстрого и соответствующего извлечения. Поддержка лексических (на основе ключевых слов) и семантических поисков (на основе значений) эти API позволяют приложениям предоставлять быстрые, соответствующие результаты на основе намерения пользователя и контекста, а не просто точных ключевых слов.

Эта возможность разблокирует следующие расширенные сценарии:

• Семантический поиск
  Приложения могут возвращать результаты на основе намерений и значений, а не точных совпадений ключевых слов.
  Примере: Запрос на "временную шкалу проекта" может отображать содержимое, которое упоминает "расписание" или "даты доставки", даже если эти точные слова не использовались.
• Генерация с дополнением извлечением (RAG)
  Индексированный контент может служить базой знаний для формируемых моделей ИИ. Когда пользователь задает вопрос, приложение извлекает наиболее важные документы или фрагменты из индекса и передает их в модель, обеспечивая точные ответы с учетом контекста, размещенные в реальных данных.

API каталога моделей Windows ML позволяют приложению или библиотеке динамически обнаруживать и скачивать большие файлы моделей ИИ из собственных каталогов моделей в Интернете, устраняя необходимость упаковать эти большие файлы непосредственно с приложением или библиотекой. Каталог моделей помогает обеспечить совместимость устройств путем фильтрации моделей и скачивания только тех, которые применимы для конкретного устройства Windows.

Последнее Microsoft.Windows.Storage.Pickers обновление упрощает выбор файлов и папок, позволяя разработчикам задавать начальные и постоянные расположения папок, а также группировать фильтры типов файлов с четкими метками для упрощения навигации.

PopupAnchor ТЕПЕРЬ API позволяет DesktopPopupSiteBridge поддерживать относительное позиционирование, привязывая к своему окну или острову, решая проблему, когда всплывающие окна ранее могли располагаться только с использованием координат экрана.

InputUnderlyingWindowController API позволяет разработчикам указать целевой HWND для получения входных сообщений, которые изначально были отправлены в ContentIsland, созданный из SystemVisual (см. ContentIsland.CreateForSystemVisual).

SystemBackdropHost позволяет размещать системный фон (акрил/мика) в любом месте визуального дерева приложения.

Это WrapPanel панель макета WinUI XAML, которая упорядочивает дочерние элементы в последовательной позиции слева направо, элементы, переполненные линией, будут автоматически разбиты на следующую строку в конце содержащей панели. Это полезно для адаптивных макетов.

Это порт существующего элемента управления из Windows Community Toolkit.

Этот выпуск включает следующие новые и измененные экспериментальные API по сравнению с 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 API-интерфейсы должны вызываться из фонового потока. Использование его в потоке пользовательского интерфейса может зависать или вызывать длительные паузы, влияющие на взаимодействие с пользователем.
• Результаты запроса с использованием AppIndexQuery.GetNextTextMatches и AppIndexQuery.GetNextImageMatches будут NULL вместо пустого списка, если нет совпадений.
• Совпадения изображений, найденные с помощью AppManagedImageQueryMatch.Subregion, основанных на значениях OCR, иногда могут быть неточными, особенно если текст повернут или искажен.
• Совпадения изображений с использованием AppManagedImageQueryMatch.Subregion иногда могут включать нулевой размер или крайне небольшие прямоугольники, что приводит к неточным результатам.
• Пустой запрос из AppContentIndex.CreateQuery может вызвать исключение.

API каталога моделей Машинного обучения Windows позволяют приложению или библиотеке динамически загружать большие файлы моделей ИИ из собственных каталогов моделей в Интернете, не отправляя эти большие файлы непосредственно с помощью приложения или библиотеки. Кроме того, каталог моделей поможет фильтровать модели, совместимые с устройством Windows, на котором он работает, чтобы правильная модель скачивалась на устройство.

Ключевые преимущества:

• Добавление каталогов: добавление одного или нескольких онлайн-каталогов
• Обнаружение совместимых моделей. Автоматический поиск моделей, которые работают с оборудованием и провайдерами выполнения пользователя.
• Скачивание моделей: скачивание и хранение моделей из различных источников
• Совместное использование моделей между приложениями: если несколько приложений используют один и тот же источник каталога, модели будут совместно использоваться на диске без дублирования загрузки

• Исправлена проблема в DeploymentManager, которая привела к неправильной отчетности PackageInstallRequired в некоторых случаях.

Этот выпуск включает следующие новые и измененные экспериментальные API:

Microsoft.UI.Composition

    CompositionNotificationDeferral
    CompositionProjectedShadow
        MaxOpacity
        MinOpacity
        OpacityFalloff

    CompositionProjectedShadowCaster
        AncestorClip
        Mask

    CompositionProjectedShadowDrawOrder
    CompositionProjectedShadowReceiver
        DrawOrder
        Mask

Microsoft.UI.Composition.Experimental

    ExpCompositionVisualSurface
    ExpExpressionNotificationProperty
    IExpCompositionPropertyChanged
    IExpCompositionPropertyChangedListener
    IExpCompositor
    IExpVisual

Microsoft.UI.Content

    ChildSiteLink
        IsBelowContent

    ContentAppWindowBridge
    ContentDisplayOrientations
    ContentExternalBackdropLink
    ContentExternalOutputLink
    ContentIsland
        Connected
        ConnectionInfo
        ConnectRemoteEndpoint
        Disconnected
        IsRemoteEndpointConnected
        Root

    ContentIslandEnvironment
        CurrentOrientation
        NativeOrientation
        ThemeChanged

    ContentSite
        TryGetAutomationProvider

    ContentSiteEnvironment
        CurrentOrientation
        NativeOrientation
        NotifyThemeChanged

    CoreWindowSiteBridge
    CoreWindowTopLevelWindowBridge
    DesktopChildSiteBridge
        AcceptRemoteEndpoint
        ConnectionInfo
        IsRemoteEndpointConnected
        RemoteEndpointConnecting
        RemoteEndpointDisconnected
        RemoteEndpointRequestedStateChanged

    DesktopPopupSiteBridge
        AnchoringBehavior
        AnchoringPixelAlignment

    DesktopSiteBridge
        TryCreatePopupSiteBridge

    EndpointConnectionEventArgs
    EndpointRequestedStateChangedEventArgs
    IContentIslandEndpointConnectionPrivate
    IContentSiteBridgeEndpointConnectionPrivate
    PopupAnchoringOptions
    PopupWindowSiteBridge
    ProcessStarter
    SystemVisualSiteBridge

Microsoft.UI.Input

    InputKeyboardSource
        GetForWindowId

    InputLayoutPolicy
    InputLightDismissAction
        GetForIsland

    InputLightDismissEventArgs
    InputPointerActivationBehavior
    InputPointerSource
        ActivationBehavior
        DirectManipulationHitTest
        GetForVisual
        GetForWindowId
        RemoveForVisual
        TouchHitTesting
        TrySetDeviceKinds

    InputPopupController
    LightDismissReason
    PopupPointerMode
    ProximityEvaluation
    TouchHitTestingEventArgs

Microsoft.UI.Input.Experimental

    ExpInputSite
    ExpPointerPoint

Microsoft.UI.Windowing

    AppWindow
        GetCurrentPlacement
        PersistedStateId
        PlacementRestorationBehavior
        SaveCurrentPlacement
        SaveCurrentPlacementForAllPersistedStateIds
        SetCurrentPlacement

    AppWindowPlacementDetails
    DisplayArea
        GetMetricsFromWindowId

    PlacementInfo
    PlacementRestorationBehavior

Microsoft.UI.Xaml

    XamlIsland
        ShouldConstrainPopupsToWorkArea

Microsoft.UI.Xaml.Automation.Peers

    AutomationEvents
        Notification

    InkCanvasAutomationPeer
    PagerControlAutomationPeer

Microsoft.UI.Xaml.Controls

    ContentDialogPlacement
        UnconstrainedPopup

    DoInkPresenterWork
    ElementFactory
    FlowLayout
    FlowLayoutAnchorInfo
    FlowLayoutLineAlignment
    FlowLayoutState
    IApplicationViewSpanningRects
    IndexPath
    InfoBar
        Opened

    InfoBarOpenedEventArgs
    InkCanvas
    ISelfPlayingAnimatedVisual
    ItemContainer
        CanUserInvoke
        CanUserInvokeProperty
        CanUserSelect
        CanUserSelectProperty
        ItemInvoked
        MultiSelectMode
        MultiSelectModeProperty

    ItemContainerInteractionTrigger
    ItemContainerInvokedEventArgs
    ItemContainerMultiSelectMode
    ItemContainerUserInvokeMode
    ItemContainerUserSelectMode
    LayoutPanel
    NumberBox
        InputScope
        InputScopeProperty
        TextAlignment
        TextAlignmentProperty

    PagerControl
    PagerControlButtonVisibility
    PagerControlDisplayMode
    PagerControlSelectedIndexChangedEventArgs
    PagerControlTemplateSettings
    ProgressRing
        DeterminateSource
        DeterminateSourceProperty
        IndeterminateSource
        IndeterminateSourceProperty

    RecyclePool
    RecyclingElementFactory
    ScrollingScrollStartingEventArgs
    ScrollingZoomStartingEventArgs
    ScrollView
        ScrollStarting
        ZoomStarting

    SelectionModel
    SelectionModelChildrenRequestedEventArgs
    SelectionModelSelectionChangedEventArgs
    SelectTemplateEventArgs
    StackLayout
        IsVirtualizationEnabled
        IsVirtualizationEnabledProperty

    StackLayoutState
    TeachingTip
        Opened

    TeachingTipOpenedEventArgs
    UniformGridLayoutState

Microsoft.UI.Xaml.Controls.Primitives

    ScrollPresenter
        ScrollStarting
        ZoomStarting

Microsoft.Windows.AI.MachineLearning

    CatalogModelInfo
    CatalogModelInstance
    CatalogModelInstanceResult
    CatalogModelSource
    CatalogModelStatus
    WinMLModelCatalog

Microsoft.Windows.ApplicationModel.WindowsAppRuntime

    DeploymentManager
        Repair

    DeploymentStatus
        PackageRepairFailed

Microsoft.Windows.AppNotifications

    AppNotification
        ConferencingConfig

    AppNotificationConferencingConfig

Microsoft.Windows.AppNotifications.Builder

    AppNotificationBuilder
        AddCameraPreview

    AppNotificationButton
        SetSettingStyle

    AppNotificationButtonSettingStyle

Microsoft.Windows.SemanticSearch

    EmbeddingVector
    SemanticSearchContract

Microsoft.Windows.Storage

    ApplicationData
        GetForUnpackaged

Microsoft.Windows.Vision

    ScreenRegionBoundingBox
    ScreenRegionDetectionContract
    ScreenRegionLabel