Windows アプリ SDK 2.0 リリース ノート

windows.diagnosticServiceModule パッケージ マニフェスト拡張機能のサポートを追加しました。 自己完結型の .NET MSIX アプリでは、この拡張機能を使用して診断モジュールを宣言できるため、Windows エラー報告がそれらを読み込み、対応に役立つクラッシュ ダンプを収集できるようになります。

新しい AppContentIndex API が、LAF トークンを取得したアプリへの制限付きアクセス機能 (LAF) として使用できるようになりました。 これらの API を使用すると、アプリは、構文マッチングを使用してそのコンテンツのインデックス作成とクエリを行い、サポートされている NPU 対応デバイスでセマンティック マッチングを行うテキストと画像のコンテンツを提供できます。 AppContentIndex では、セマンティック検索と取得拡張生成 (RAG) シナリオがサポートされています。 (RuntimeCompatibilityChange: AppContentSearchNewAPI_LafCheck)

• ポップアップのアイランドが破棄された後にフォーカスまたはポインター イベントが処理されたときのウィンドウ ポップアップ入力処理のクラッシュを修正しました。 (ランタイム互換性の変更: PointerInputProcessor_ReleaseCaptureOnDisposedIsland)
• コントロールのサイズ変更時に負のペインNavigationViewが生成される可能性があったため、MaxHeight内で発生していたクラッシュを修正しました。 (RuntimeCompatibilityChange: NavigationView_UpdatePaneLayoutNegativeMaxHeight)
• ポインターが押下されている間、ElementCompositionPreview.GetPointerPositionPropertySet によって返されるプロパティ セットが更新されなくなる問題を修正しました。 (ランタイム互換性の変更: 押下中の PointerPositionPropertySet の更新)
• アイテムが折りたたまれた後または再利用された後に、その展開済みアイテムのフライアウトが表示されると NavigationView がクラッシュする問題を修正しました。 (RuntimeCompatibilityChange: NavigationViewItem_遅延フライアウト表示で古い状態を表示する)
• KeyboardAcceleratorが OEM キーまたは句読点キー (コンマ、セミコロン、角かっこなど) を使用し、アクセラレータのショートカット ラベルを表示した場合の高速失敗を修正しました。 (RuntimeCompatibilityChange: KeyboardAccelerator_OemKeyNoFailFast)
• 複数の UI スレッドで WinUI 3 をホストするアプリで XAML シャットダウン中に発生する可能性がある致命的なプロセスの終了を修正しました。 (RuntimeCompatibilityChange: WindowsXamlManager_ActivationFactoryCacheResetRace)
• セカンダリ コマンドのない CommandBar が、175%などの小数部の表示スケールで空のオーバーフロー ボタンを表示する可能性がある問題を修正しました。 (RuntimeCompatibilityChange: 小数スケール時の CommandBar の不要なオーバーフロー ボタン)
• システムコンポジション エンジンを使用するアプリが VisualInteractionSource.CreateFromIVisualElementを呼び出すのを妨げる問題を修正しました。 (RuntimeCompatibilityChange: CompositionEngine_SwitcherSeptemberFixes)
• システムコンポジションエンジンを使用したアプリのエフェクトグラフと SceneLighting レンダリングを修正しました。 (RuntimeCompatibilityChange: CompositionEngine_SwitcherSeptemberFixes)
• システムコンポジションエンジンの使用時にNoActivateを優先しないInputPointerSource.ActivationBehaviorを修正しました。 (RuntimeCompatibilityChange: CompositionEngine_SwitcherSeptemberFixes)
• null 入力と no-op 選択の CompositionEngine 選択動作を修正しました。 (RuntimeCompatibilityChange: CompositionEngine_SwitcherSeptemberFixes)
• システムコンポジションエンジン使用時のリフトされた入力のカーソルのカスタマイズを修正しました。 (RuntimeCompatibilityChange: CompositionEngine_SwitcherSeptemberFixes)
• システムコンポジション エンジンを使用する場合のグラデーションストップ コレクションに対する ICompositionObject クエリを修正しました。 (RuntimeCompatibilityChange: N/A、オペレーティング システム構成の修正)
• システムコンポジションエンジン ContentExternalOutputLink 使用するときの境界線と背景の動作を修正しました。 (RuntimeCompatibilityChange: N/A、オペレーティング システム構成の修正)
• システムコンポジションエンジン使用時の VisualReferenceController へのアクセスを修正しました。 (RuntimeCompatibilityChange: N/A、オペレーティング システム構成の修正)
• Windows アプリ SDKのインストール時に発生する可能性がある登録の問題を修正しました。 (RuntimeCompatibilityChange: N/A、デプロイ登録の修正)
• 更新された ONNX ランタイムの依存関係を使用した初期化または推論中に、Video Super Resolution が失敗する可能性がある問題を修正しました。 (RuntimeCompatibilityChange: N/A、依存関係の互換性の更新)

このリリースには、2.4.0 リリースと比較した次の新しい API が含まれています。

Microsoft.Windows.Search.AppContentIndex

    AppIndexContentRegion
        CreateFromBitmap
        CreateFromImageStream

    AppManagedIndexableAppContent
        CreateFromBitmap
        CreateFromImageStream

    ContentRegionImageOptions

    ContentRegionTextOptions
        AllowSemanticIndexing

    ImageOcrIndexingOptions

WinUI 3 アプリでは、オペレーティング システムとハードウェアでサポートされている場合、オペレーティング システムのタッチパッドとマウスの触覚が、 Windows.Devices.Hapticsを介して、タッチパッドのシングル フィンガー パンと共にサポートされるようになりました。 (RuntimeCompatibilityChange: InputPointerSource_OSHaptics)

• タッチまたはペンの接触が正確なタイミングでスクロール可能な領域を離れた場合に発生する可能性があるクラッシュを修正しました。 (RuntimeCompatibilityChange: InputPointerSource_DepartingScrollInputCrashFix)
• ファイル ダイアログを閉じた後、ストレージ ピッカー (FileOpenPicker、 FileSavePicker、 FolderPicker) がキーボード フォーカスなしで呼び出し元の WinUI アプリ ウィンドウを離れる問題を修正しました。 ダイアログが閉じた後、アプリは以前のフォーカスを復元するようになりました。 詳細については、問題 #6505 GitHub参照してください。 (RuntimeCompatibilityChange: StoragePickers_RestoreFocusAfterDialogCloses)
• PRI ファイルが存在しない場合に、文書化されたフォールバック パスではなく ERROR_FILE_NOT_FOUND を返していた MrmGetFilePathFromName の回帰を修正しました。 詳細については、GitHub問題 #5940 を参照してください。 (RuntimeCompatibilityChange: ResourceManager_RestoreDefaultFallbackPath)
• 子プロセスによって MICROSOFT_WINDOWSAPPRUNTIME_BASE_DIRECTORY が継承され、MRT Core とカタログの参照が中断される問題を修正しました。 詳細については、問題 #5987 GitHub参照してください。 (RuntimeCompatibilityChange: WindowsAppRuntime_BaseDirectoryIsolation)
• サポートされていない言語または入力言語と出力言語が一致しない場合に、 LanguageModel が一般的な Error 状態を返す問題を修正しました。 これらの条件は、それぞれ LanguageModelResponseStatus.UnsupportedLanguage と LanguageModelResponseStatus.LanguageMismatchを返すようになりました。 (RuntimeCompatibilityChange: LanguageModel_LanguageDetectionStatus)
• VisualInteractionSource.TryRedirectForManipulationと呼ばれるシステムコンポジション エンジンを使用するアプリのクラッシュを修正しました。 (RuntimeCompatibilityChange: N/A、オペレーティング システム構成ブリッジの修正)
• DISABLE_XAML_GENERATED_MAINが定義されている場合に生成された C# エントリ ポイント ヘルパーのアクセス修飾子を修正しました。 詳細については、問題 #11245 GitHub参照してください。 (RuntimeCompatibilityChange: N/A、ビルド時ツールの変更)

このリリースには、2.3.1 リリースと比較した次の新しい API が含まれています。

Microsoft.Windows.AI.Text

    LanguageModelResponseStatus
        LanguageMismatch
        UnsupportedLanguage

呼び出し元が指定した JSON スキーマに制約された言語モデルの応答を生成する構造化 JSON 出力 API (Microsoft.Windows.AI.Text.LanguageModel.GenerateStructuredJsonResponseAsync) を追加しました。 (RuntimeCompatibilityChange: 言語モデルの構造化 JSON 出力)

XamlOptionalChanges API が追加されました。これにより、アプリは XAML の初期化前に省略可能な破壊的変更をオプトインできます。 詳細については、GitHub PR microsoft/microsoft-ui-xaml#11110 を参照してください。 (RuntimeCompatibilityChange: XamlSettings_OptionalChangesApi)

DISABLE_XAML_GENERATED_MAIN プリプロセッサ定数の動作が変更され、定義されると、生成されたmain() メソッドの名前が変更されるようになりました (C#: XamlGeneratedProgram.XamlGeneratedMain();C++/WinRT: wXamlGeneratedMain()) 全体を削除する代わりに、 これにより、カスタム main() メソッドが既定の実装を呼び出すことができます。

CompositionEngine API を不安定な制限付きアクセス機能 (LAF) として追加しました。これにより、アプリは Composition API のエンジンとして OS を使用することを選択できます。 (RuntimeCompatibilityChange: CompositionEngine_API)

ビデオスーパー解像度の NPU 検出、CPU サポートの追加、パフォーマンスの向上を修正しました。 (RuntimeCompatibilityChange: VideoSuperResolution_HardwareDetection)

• 特定のシナリオでの実行プロバイダーの列挙を修正しました。 (ランタイム互換性の変更: WindowsML_実行プロバイダー列挙の更新)
• Windows ML ARM64ECサポートを追加しました。

Microsoft.WindowsAppSDK.AI NuGet パッケージに安定した API の IntelliSense ドキュメントを追加しました。

以下のいくつかの最適化はオプトインです。 それらを有効にするには、各項目に示されているように、指定された XamlChangeId を設定します。

• 最適化されたXamlControlsResources テンプレートなど、新しい最適化されたScrollBar スタイルが追加されました。 DefaultStyleOptimizations XamlChangeId を使用して、これらのスタイルにオプトインします。 (RuntimeCompatibilityChange: Xaml_DefaultStyleOptimizations)
• FontIcon と BitmapIcon は、Grid XamlChangeId でオプトインしたアプリのビジュアル ツリーに余分な IconNoGridOptimization を挿入しません。 (RuntimeCompatibilityChange: Xaml_IconNoGridOptimization)
• 値を適用しないプロパティ セッター Style 読み込みを停止しました。 OptimizeApplyStyles XamlChangeId を使用してオプトインします。 (RuntimeCompatibilityChange: Xaml_DeferStylePropertySetters)
• 要素がツリー内になるまで、 FrameworkElement スタイルと Control スタイルの適用を遅延しました。 OptimizeApplyStyles XamlChangeId を使用してオプトインします。 (RuntimeCompatibilityChange: Xaml_DelayApplyStylesAfterCreationComplete)
• Visual State Manager のステート全体を読み込まないことで、CommandBar の初期化を最適化しました。 (RuntimeCompatibilityChange: Xaml_OptimizedCommandBarInitialization)
• CommandBarFlyoutのPrimaryCommandsとSecondaryCommandsに追加するパフォーマンスが向上しました。 (RuntimeCompatibilityChange: Xaml_OptimizedCommandBarFlyoutUpdateCommands)
• ResourceDictionaryによりパフォーマンスの高いハッシュ テーブルを使用しました。 (RuntimeCompatibilityChange: Xaml_FasterResourceDictionary)
• 遅延リソースの読み込み時に、リソースキー文字列のコピーと比較が不要になるよう最適化しました。 (RuntimeCompatibilityChange: Xaml_LoadDeferredResourceOptimization)
• 文字列比較を減らすことで、 ThemeResource 参照のパフォーマンスが向上しました。 (RuntimeCompatibilityChange: Xaml_ThemeResourceUseResourceKeys)
• リソース キー ハッシュのオーバーヘッドを減らすことで、XAML テーマのリソース参照中の CPU パフォーマンスが向上しました。 (RuntimeCompatibilityChange: Xaml_ReduceThemeResourceLookupHashing)
• UIElementとFrameworkElementに関する一般的な内部 XAML 型チェックの CPU パフォーマンスが向上しました。 (RuntimeCompatibilityChange: Xaml_CachedTypeChecks)
• 内部アクティブ化ファクトリ参照パスの CPU パフォーマンスが向上しました。 (RuntimeCompatibilityChange: Xaml_ActivationFactoryFastPaths)
• XBF ファイルに格納されている整数のデコードのパフォーマンスが向上しました。 (RuntimeCompatibilityChange: Xaml_FasterXbfIntLoading)
• ベクター メモリを予約し、RAII ヘルパーを最適化することで、スタートアップ パスとツリー トラバーサルでのヒープ割り当てを減らしました。 (RuntimeCompatibilityChange: Xaml_ReserveVectorSpace)
• 複数の項目を追加する前にトラッカー コレクションの領域を予約することで、パフォーマンスが向上しました。 (ランタイム互換性の変更: Xaml_ReserveTrackerCollectionSpace)
• XamlUICommand プロパティ バインド用に最適化されたバインディング。 (RuntimeCompatibilityChange: XamlUICommand_LightweightBindings)
• キーボード アクセラレータを定義していない XamlUICommandをバインドするときのパフォーマンスが向上しました。 (RuntimeCompatibilityChange: XamlUICommand_SkipEmptyKeyboardAcceleratorBinding)
• コードではなく、既定のスタイルのTintLuminosityOpacity オブジェクトのマークアップでAcrylicBrush プロパティを初期化し、強制的な実現を回避します。 (RuntimeCompatibilityChange: AcrylicBrush_InitializePropertyInMarkup)
• 要素ツリーを開始または終了するときに、ContextFlyoutとTextBlockでの不要な既定のRichTextBlock初期化を回避しました。 DeferContextFlyoutInit XamlChangeId を使用してオプトインします。 (RuntimeCompatibilityChange: Xaml_DeferContextFlyoutInit)
• UI スレッドで後で行う代わりに、バックグラウンド デバイスの作成時に XAML の D3D デバイス削除イベントを登録することで、Direct3D ロックの競合に対するスタートアップ待機を減らしました。 (RuntimeCompatibilityChange: Xaml_EagerDeviceRemovedEventRegistration)
• RefreshRateInfoから冗長な電源通知登録を削除し、スタートアップのオーバーヘッドを削減しました。 (RuntimeCompatibilityChange: RefreshRateInfo_RemovePowerNotification)
• コンパイル時にログに記録されたランタイム バージョンを計算して、WinUI スタートアップ パスから冗長な version.dll 依存関係を削除しました。 (RuntimeCompatibilityChange: XamlInit_GetMuxVersionCompileTime)

• ポインターイベントの再生中にポップアップが同期的に閉じられた際に CPopupRoot::ReplayPointerUpdate で発生する解放後使用によるクラッシュを修正しました。 (RuntimeCompatibilityChange: CPopupRoot_ReplayPointerUpdateCrash)
• XAML アイランドの破棄中に、UI オートメーション の再入可能なクエリが原因で CXamlIslandRoot::GetScreenOffset で発生するアクセス違反を修正しました。 (RuntimeCompatibilityChange: XamlIslandRoot_UiaTeardownReentrancyCrash)
• 兄弟レイアウト パスでリサイクルされたビューポート追跡対象のコンテナーまたはヘッダーによって古いアンカーが残され、次回の測定時に fail-fast を引き起こすことがあった ModernCollectionBasePanel のクラッシュを修正しました。 (RuntimeCompatibilityChange: ModernCollectionBasePanel_StaleViewportAnchorRecycle)
• ToolTip の close でメッセージがポンプ処理されて close パスに再入したときに発生する、CPopup::RemoveChild におけるフェイルファストを修正しました。 (ランタイム互換性の変更: Popup_RemoveChildIdempotentWhenClosing)
• UI オートメーション クライアントがアクティブな場合に Popup デストラクタが UIADisconnectAllProviders を引き起こした際に発生する、CXcpDispatcher での再入によるクラッシュを修正しました。 (RuntimeCompatibilityChange: UIAWindow_PauseNewDispatchOnDisconnectProviders)
• そのアイランドまたはディスパッチャーが終了処理を開始した後に、カスケード メニューまたは AutoSuggestBox の遅延オープン タイマーが作動した場合に発生するクラッシュを修正しました。 (RuntimeCompatibilityChange: CascadingMenuHelper_DelayOpenTimerTickAfterUnload)
• カスタム メタデータ型内の COM ポインターが適切に解放されなかった場合に、DLL のアンロード時に解放後使用クラッシュが発生するおそれがある問題を修正しました。 (RuntimeCompatibilityChange: CustomMetadataTypes_InvalidateUseAfterFree)
• フォーカス変更中のディスパッチャーの再入により、CompositionTarget.Rendering コールバックから Popup を開くとクラッシュする問題を修正しました。 (RuntimeCompatibilityChange: CPopup_OpenSetFocusReentrancy)
• メディア再生イベントの処理中に GPU デバイスが失われた場合の MediaPlayerPresenter のクラッシュを修正しました。 (RuntimeCompatibilityChange: MediaPlayerPresenter_DeviceLostCrash)
• グリフラン テクスチャの構築中にデバイス ロストからの回復が発生した場合に、Direct2D のテキスト レンダリングでアクセス違反が発生する可能性がある問題を修正しました。 (RuntimeCompatibilityChange: HWBuildGlyphRunTextures_DeviceGuardScope)
• CFocusRectManager::FindFocusRectHostまたはInlineUIContainerのRichTextBlockを介してインラインでホストされているコントロールにフォーカスが移動すると、TextBlockがクラッシュする問題を修正しました。 (RuntimeCompatibilityChange: FocusRectManager_FindFocusRectHostCrash)
• バックグラウンド タスクに CLSID が格納されていない場合に backgroundTaskHost.exe を繰り返し停止する可能性があるクラッシュを修正し、 CoCreateInstance が失敗したときにグレースフル処理を追加しました。 詳細については、問題 #5870 GitHub参照してください。 (RuntimeCompatibilityChange: UniversalBGTask_RunCrash)
• 画面下部付近で上方向に開く際、横方向配置のウィンドウ化されたフライアウトおよび非ウィンドウ化フライアウトが、親項目の約 1 項目分上にずれて表示される問題を修正しました。 (RuntimeCompatibilityChange: Flyout_SidePlacementFlipUpAlignmentFix)
• すでに読み込まれていない ItemsRepeater でコレクション変更が通知された場合に UniformGridLayout および FlowLayout で発生する可能性があったクラッシュ (null LayoutState の逆参照) を修正しました。 (RuntimeCompatibilityChange: UniformGridLayoutFlowLayout_OnItemsChangedNullLayoutStateCrash)
• レジストリ キーを間違ったパス (ApplicationData.GetForUnpackaged().LocalSettings() ではなくHKCU\SOFTWARE\publisher\product) で開くHKCU\SOFTWARE\Classes\Local Settings\Software\publisher\productを修正しました。これは、コンピューターに対してローカルではなくローミング場所です。 詳細については、GitHub問題 #6559 を参照してください。 (RuntimeCompatibilityChange: ApplicationData_GetForUnpackaged_LocalSettings)
• UI スレッドの同時入力でアプリがクラッシュする可能性があるキーボード修飾子の状態処理の競合状態を修正しました。 (ランタイム互換性の変更: WindowsServices_GetKeyboardModifiersStateRace)
• パッケージのインストール、更新、またはアンインストール中に発生する可能性がある AppxSvc のクラッシュを修正しました。 (RuntimeCompatibilityChange: N/A、サービス ホストのクラッシュ修正)

このリリースには、2.2.0 リリースと比較した次の新しい API が含まれています。

Microsoft.UI.Composition

    CompositionEngine
    CompositionEngineType

Microsoft.UI.Xaml.Settings

    XamlChangeId
    XamlOptionalChanges

Microsoft.Windows.AI.Text

    GenerateStructuredJsonResponseResult
    GenerateStructuredJsonResponseStatus
    LanguageModel
        GenerateStructuredJsonResponseAsync

Microsoft.Windows.AI.Video.VideoScaler API は、会話中のユーザーを特徴とするストリーム用に最適化された高度な AI アップスケーリングを通じて、リアルタイムのビデオ強化を実現します。 これにより、開発者は、ネットワークの状態が悪い場合でも、会議、ストリーミング、編集プラットフォーム全体で、より鮮明で明確なビジュアルを提供できます。 この API では、BGR、RGB、NV12 などの複数のビデオ形式との互換性を備えた、出力解像度、フレーム レート、関心領域のカスタマイズがサポートされています。

VideoScaler は破棄可能であり、アプリが実行時に VSR サポートを検証できるように機能チェックが含まれています。 ML の明示的なWindows初期化は必要ありません。

新しい Microsoft.Windows.Storage.ApplicationData.GetForUnpackaged() API を使用すると、パッケージ化されていないアプリに、ユーザーごとまたはマシンごとのアプリケーション データに対する最上位クラスの WinRT エントリ ポイントが提供され、以前はパッケージ化されたアプリでのみ使用可能だったサーフェスと一致します。 これにより、パッケージ化↔されていない将来の移行が簡略化され、Registry-API 回避策が不要になります。

XamlBindingHelper (SetPropertyFromThickness、SetPropertyFromCornerRadius、SetPropertyFromColor) にボックス化なしの値セッター オーバーロードを追加し、Setter.ValueProperty依存関係プロパティを公開しました。

• RenderTargetBitmapが完了する前に、ターゲット要素がビジュアル ツリーを離れると (ポップアップが閉じるなど)、PreCommitがクラッシュする問題を修正しました。 RenderAsync では、クラッシュする代わりに E_ABORT が返されるようになりました。 (RuntimeCompatibilityChange: RenderTargetBitmap_PreCommitCrashOnTreeLeave)
• コントロールが破棄された時点でその hide-indicators タイマーの tick がまだ保留中だった場合に ScrollView で発生する、解放後使用によるクラッシュを修正しました。 詳細については、GitHub問題 #10514 を参照してください。 (RuntimeCompatibilityChange: ScrollView_HideIndicatorsTimerUseAfterFree)
• Microsoft.UI.Xaml.dll!DirectUI::DXamlCore::GetPeerPrivateで、解放するようにスケジュールされたオブジェクトにアクセスしようとした場合に発生する可能性があるクラッシュを修正しました。 (RuntimeCompatibilityChange: GetPeerPrivate_UseAfterFree)
• Microsoft.UI.System.ThemeSettingsがバックグラウンド スレッドで破棄された場合 (たとえば、.NET ガベージ コレクターによって破棄された場合) にアプリがクラッシュする可能性がある問題を修正しました。 (RuntimeCompatibilityChange: ThemeSettings_OffThreadDestructorFix)
• ペン入力が優先される場合など、入力ハードウェアによってアクティブなタッチ接点がキャンセルされた際に、特定のデバイスで発生することがあったクラッシュを修正しました。 (RuntimeCompatibilityChange: InputPointerSource の PointerCancel クラッシュ修正)
• スパース パッケージ アプリでモジュール固有の PRI ファイルを検出できない問題を修正しました。 詳細については、GitHub問題 #6375 を参照してください。 (RuntimeCompatibilityChange: MRTCore_SparsePackagedPriFallback)
• Flat-C Windows ML Catalog API を使用するときの文字列所有権のバグを修正しました。 (RuntimeCompatibilityChange: WindowsMLFlatCCatalog_CallbackStringOwnership)
• プロセスのシャットダウン中にWindows ML で発生する可能性がある問題を修正しました。 (RuntimeCompatibilityChange: WindowsML_ComRundownFix)
• Windows ML での COM の初期化と破棄に関する潜在的な問題を修正しました。 (RuntimeCompatibilityChange: WindowsML_ComInitializationFix)

このリリースには、2.1.3 リリースと比較した次の新しい API が含まれています。

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

ドラッグ可能なTitleBarのどの部分TitleBar.Content決定するかを改善し、開発者がドラッグ領域を明示的に制御できるようにする API を追加します。 PR microsoft/microsoft-ui-xaml#10936 と問題 #10421 の追跡を参照してください。

変更された内容

• 新しい既定の動作 - フレームワークはビジュアル ツリーを再帰的にウォークし、ドラッグ領域から 対話型コントロール のみを自動的に除外するようになりました。 空のギャップと非対話型ビジュアルは 既定でドラッグ可能であり、マークアップの変更は必要ありません。
• 明示的な制御のための新しい API:
  • TitleBar.IsDragRegion — 要素をドラッグ可能 (True)、クリック可能 (False)、またはフレームワークにより決定される (未設定) として示すための、アタッチされた null 許容の bool 値。
  • TitleBar.AutoRefreshDragRegions — Trueすると、レイアウトの更新時にドラッグ領域が自動的に更新されます。
  • TitleBar.RecomputeDragRegions() — 動的コンテンツの変更後にドラッグ領域を手動で再計算します。

理由

カスタム タイトル バーでは、多くの場合、対話型コントロールと非対話型ビジュアルが Grid/StackPanel レイアウト内に混在します。 以前の「コンテンツ領域全体をくり抜く」アプローチでは、空き領域、不均一な間隔、または動的な UI を含むレイアウトで 予期しないドラッグできない隙間 が生じていました。

視覚的な比較

既定の (前の) 動作 — ドラッグできないギャップ:

空の中央領域はドラッグ できません 。

現在の（新しい）挙動 — ギャップはドラッグ可能、対話型コントロールは除外。

空のスペースはドラッグ可能です。対話型コントロールは正しく除外されます。 (RuntimeCompatibilityChange: タイトル バーのコンテンツのドラッグ領域)

Phi Silica 用の Low-Rank アダプター (LoRA) API が安定するように昇格されました。

LoRA を使用すると、開発者は独自のカスタム データを使用してデバイス上の Phi Silica 言語モデルを微調整し、財務、医療、教育などの特定のシナリオに合わせて出力を調整できます。 LanguageModelLowRankAdapter.CreateFromPathを使用してアダプターを読み込み、LanguageModelOptions.LowRankAdapterを呼び出すときにGenerateResponseAsync経由で渡します。 詳細については 、Phi Silica LoRA を参照してください。

新しい AICapabilities.HasAICapability API を使用すると、サード パーティのアプリケーションでデバイスがCopilot+ PCかどうかを判断できます。

ONNX Runtime のバージョンが 1.24.6 に更新されました。 詳細については 、ONNX ランタイムのバージョン を参照してください。

• 1 つの MSIX パッケージ内で複数の実行プロバイダーのサポートを追加しました。 (RuntimeCompatibilityChange: WindowsML_MultiEpPerPackage)
• フレームワーク パッケージとして提供される実行プロバイダーの検出のサポートを追加しました。 (RuntimeCompatibilityChange: WindowsML_FrameworkEpEnumeration)
• 柔軟なデプロイ構成用の実行プロバイダー選択モードを追加しました。 (RuntimeCompatibilityChange: WindowsML_EpSelectionMode)

• ItemsRepeater において、RecyclePool を通じた参照ループにより再利用された要素がガベージ コレクションの対象とならなかったことによるメモリ リークを修正しました。この問題は、InvalidateChildrenMeasure でのクラッシュの原因となる可能性もありました。 (ランタイム互換性の変更: ItemTemplateWrapper_RecyclePoolLeak)
• 暗黙的な Show/Hide アニメーション完了コールバックが破棄された CUIElement にアクセスしてアクセス違反を引き起こし、クラッシュする問題を修正しました。 コールバックは弱参照を使用して、アニメーションが完了する前に要素が破棄されるケースを安全に処理するようになりました。 (ランタイム互換性の変更: Animation_FixImplicitHideAnimationCrash)
• XAML Island で開かれたウィンドウ表示のポップアップ コンテンツが OverrideScaleを考慮せず、コンテンツがオーバーサイズでクリップされる問題を修正しました。 詳細については、GitHub問題 #11000 を参照してください。 (RuntimeCompatibilityChange: Popup_WindowedPopupOverrideScale)
• UIAffinityReleaseQueue::DoCleanup における、アパートメント間の COM 解放処理中の再入可能なディスパッチによって引き起こされていたフェイル ファストのクラッシュを修正しました。 (RuntimeCompatibilityChange: UIAffinityReleaseQueue_PauseDispatchDuringCleanup)
• WinUI: 同じ名前の複数のモジュールが同じプロセスで読み込まれる場合のあいまいなモジュール参照を修正しました。 GetModuleHandleW は GetModuleHandleExW に置き換えられたため、正しいモジュールはアドレスによって解決されます。 (ランタイム互換性の変更: GetModuleHandle_FixAmbiguousModuleLookup)
• ItemsRepeater が 1 項目分のマイナー ストライドより狭い使用可能幅でレイアウトされたときに UniformGridLayout::GetMajorSize で発生する、整数の 0 除算によるクラッシュを修正しました。 (RuntimeCompatibilityChange: UniformGridLayout_GetItemsPerLineDivideByZero)
• 処理前にパッケージがアンインストールされた場合のクラッシュの可能性を修正しました。 (RuntimeCompatibilityChange: PackageManager_FixCrash)
• 必要なパッケージがまだデプロイされていない場合に、 GetReadyState が正しくないエラー コード ( DisabledByUser や NotSupportedOnCurrentSystemなど) を返す可能性がある問題を修正しました。 API では、このシナリオで NotReady が正しく報告され、診断の明確さが向上しました。 (ランタイム互換性の変更: ModelInitialization_GetReadyStateAvailabilityGuard)
• 最初のトークンが返される前の待機時間のソースをより適切に識別できるように、 LanguageModel.GenerateResponseAsync の内部パフォーマンス診断が改善されました。 (RuntimeCompatibilityChange: LanguageModelInsights_GetPartialResultLatency)
• dotnet buildを使用すると XAML コンパイラ エラーが警告なしに失われ、実際のエラー メッセージではなくMSB3073: exited with code 1のみが表示される問題を修正しました。 詳細については、GitHub問題 #9813 を参照してください。 (RuntimeCompatibilityChange: N/A、ビルド時 XAML コンパイラ ツールの変更)
• Microsoft.Windows.Workloads.dllが 22000 より前のWindows ビルドで読み込めなかった問題を修正しました。これらの OS バージョンでは動的依存関係 API の静的インポートが使用できないためです。 関数が動的に解決されるようになったため、サポートされていない OS バージョンでのエラーは、ローダー エラー ダイアログの代わりに通常の HRESULT として表示されます。 (RuntimeCompatibilityChange: N/A、包含なし)

このリリースには、2.0.1 リリースと比較した次の新しい API が含まれています。

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

Windows アプリ SDK 2.0 は、Semantic Versioning 2.0.0 で標準化された新しいWindows アプリ SDKバージョン管理スキームの最初のリリースです。 メジャー バージョン番号をインクリメントするのはこれが初めてでもあります。

新しいスキームでは、Windows アプリ SDK バージョンを NuGet パッケージのバージョンに合わせて調整することで、バージョン管理を簡略化します。 プロジェクトで Windows アプリ SDK 2.0 を参照すると、対応する NuGet バージョンが使用され、追跡する日付ベースのビルド番号が個別に指定されなくなります。

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

パッケージ ファミリ名もマイナー バージョンではなくメジャー バージョンと一致するため、Windows アプリ SDKの次のサイド バイ サイド リリースはバージョン 3.0.0 になります。 SemVer では、重大な変更はメジャー バージョンの更新プログラムでのみ許可されます (Windows アプリ SDK デプロイ アーキテクチャを参照)。

Microsoft.WindowsAppSDK.ML NuGet パッケージがリファクタリングされ、新しい基本依存関係が追加されました。 既存の ML NuGet パッケージの機能は変わりませんが、ML 機能Windowsコアは、Microsoft.Windows.AI.MachineLearning という基本パッケージにリファクタリングされています。 この新しいパッケージには、最小限の依存関係セットが含まれています。Windows 10 v1903 までアプリをサポートします。 v1809 サポートWindows 10必要な場合は、既存の Microsoft.WindowsAppSDK.ML パッケージを引き続き使用してください。

ONNX ランタイム。 Windows ML に含まれる ONNX ランタイムのバージョンが 1.24.5 に更新されました。 詳細については 、ONNX ランタイムのバージョン を参照してください。 このリリースには、 OrtModelEditor API によって生成されたグラフを使用したモデルのコンパイルをサポートするための追加の ORT API の変更も含まれています (前の OrtCompileApi サーフェスの機能ギャップ)。 この変更は非破壊的であり、今後の WebNN のブラウザー シナリオを解除するために行われました。詳細については、基になる ONNX ランタイム PR #27332 を参照してください。

ライセンス。 WINDOWS ML ライセンス契約は、ISV に関するより明確な条件で簡略化されています。

• わかりやすくするために、再構築されたインストール、データ、および再頒布可能コードのセクション。
• 新しい実行プロバイダー (EP) コンプライアンスに関する通知セクションでは、ハードウェア高速化実行プロバイダーに関する開発者の責任を明確にしています。
• NVIDIA TensorRT、Intel OpenVINO、Qualcomm QNN (Qualcomm Neural Network SDK) のベンダー ライセンス契約への直接リンク。

• Phi Silica API は、制限付きアクセス機能 (LAF) の一部として適用されるようになりました。 詳細については 、Phi Silica を参照してください。
• AIFeatureReadyStateに新しい状態が追加され、AI モデルの取得プロセス中の一時的な障害と永続的な障害 (CapabilityMissing、AIFeatureReadyState、OSUpdateNeeded) をアプリで説明できるようになりました。 アプリでは、これらの状態を使用して、すべての "準備ができていません" 状態を一般的なエラーとして扱う代わりに、ユーザーに実用的なガイダンスを提供できます。
• AI モデルのインストール中にさまざまなネットワークエラーとWindows Updateエラーのチェックが追加され、ユーザーはモデル パッケージのインストールに失敗した理由を理解できるように永続的なエラーにフラグを設定しました。
• Windows AI シナリオで使用されるテキスト インテリジェンス API の診断可能性が向上しました。

WinUI 3 アプリケーションでホストされている WebView2 コンテンツのドラッグ サポートを有効にしました。 この機能は以前はサポートされておらず、新しいパブリック API を導入せずに使用できるようになりました。 (外部ソースからの WebView2 コントロールへのドロップは既にサポートされています)。

サポートされるシナリオ:

• 標準のドラッグ アンド ドロップ コンテンツ。 テキスト、HTML、画像、URL のドラッグがサポートされています。 現在、アプリの外部でイメージをドラッグすると、エクスプローラーにドロップされると、既定のファイル名 ( download.jpgなど) が作成されます。
• ドラッグ操作のキャンセル。 アクティブなドラッグ操作のオンデマンドキャンセルがサポートされているため、アプリはドラッグが開始された後、制限付きコンテンツまたは一時的なコンテンツのドラッグ操作を条件付きでブロックできます。
• カスタムドラッグビジュアル。 アイコンやプレビューなどのカスタム ドラッグ UI は、ユーザーがドラッグするコンテンツを明確に識別できるようにサポートされています。
• カスタマイズ可能なドラッグ データ。 ドラッグ データの編集とカスタマイズがサポートされており、アプリ内でのメッセージのドラッグや、転送先がドロップ時に読み取ることができるコンテキスト メタデータ ("from <app name>" の添付など、アプリ固有のシナリオが有効になります。

Limitations:

• DownloadURLなど、一部の追加のドラッグ データ型は現在サポートされていません。

Requirements:

• 最小 WebView2 ランタイム バージョン (Edge ベータ チャネル): 144.0.3719.11。

Microsoft.Windows.Storage.Pickers API (Windows アプリ SDK 1.8 で導入) は、開発者が最初と永続的なフォルダーの場所とグループ ファイルの種類フィルターを明確なラベルで設定してナビゲーションを容易にできるようにすることで、ファイルとフォルダーの選択を効率化するように拡張されました。

• FileOpenPicker は、 FileTypeChoices、 InitialFileTypeIndex、 SettingsIdentifier、 SuggestedFolder、 SuggestedStartFolder、および Titleを追加します。
• FileSavePicker は、 InitialFileTypeIndex、 SettingsIdentifier、 ShowOverwritePrompt、 SuggestedStartFolder、および Titleを追加します。
• FolderPicker は、 PickMultipleFoldersAsync、 SettingsIdentifier、 SuggestedFolder、 SuggestedStartFolder、および Titleを追加します。

• ポップアップの相対位置。 新しい PopupAnchor API を使用すると、 DesktopPopupSiteBridge が独自のウィンドウまたはアイランドに固定して相対位置をサポートし、画面座標を使用してのみポップアップを絶対に配置できる制限に対処できます。 新しい DesktopPopupSiteBridge.AnchoringBehavior プロパティと DesktopPopupSiteBridge.AnchoringPixelAlignment プロパティは、アンカー動作を制御します。
• キーボード ヒントのガイダンス。 新しい InputFocusController.ShouldShowKeyboardCues プロパティは、 ContentIslandの作成直後にキーボード キューを表示するかどうかを開発者に指示します。
• PointerPoint の便利な API。 新しいPointerPoint.GetCurrentPointメソッドを使用すると、開発者は提供されたPointerPointからアクティブなpointerId データを取得できます。

新しい Microsoft.UI.Xaml.Controls.SystemBackdropElement は、軽量な FrameworkElement であり、アプリは、XAML レイアウト内の任意の場所に Mica や Acrylic などのシステム背景を配置し、丸められた背景領域に対して CornerRadius プロパティを使用できます。 WinUI 3 は、アプリ内で使用されるアクリル効果 (以前は AcrylicBrush.BackgroundSource を使用して WinUI 2 で簡単に実現できた) に直接の対応がないという長年の課題を解決します。

Microsoft.Windows.Management.Deployment 名前空間は、パッケージ検証フレームワークと、パッケージがステージングされるストレージ ボリュームを管理するための PackageVolume API を追加します。

• バリデーター。 新しいIPackageValidator インターフェイスと、新しいPackageCertificateEkuValidator プロパティを介してPackageFamilyNameValidatorPackageMinimumVersionValidatorAddPackageOptionsにアタッチできる 3 つの組み込み検証コントロール ( / 、StagePackageOptions、PackageValidators)。 PackageValidationEventArgs、PackageValidationEventSource、およびPackageValidationHandlerは検証イベントを提供します。IsPackageValidationSupportedとGetValidationEventSourceForUriは呼び出し元がデプロイを実行する前にサポートを確認できるようにします。
• パッケージ体積。 ランタイム機能検出 (PackageVolume) のGetDefault、GetPackageVolumeByName、GetPackageVolumeByPath、AddAsync、RemoveAsync、GetAvailableSpaceAsync、IsOffline、SetDefault、SetOfflineAsync、SetOnlineAsync、およびIsFeatureSupportedを含む新しいPackageVolumeFeatureの種類。

新しい IXamlCondition インターフェイスを使用すると、開発者は XAML の条件付き名前空間構文と統合し、XAML 解析時に評価されるカスタム条件を定義できます。 これにより、試験的な IXamlPredicate インターフェイスが置き換えられます。 カスタム条件により、機能フラグ、デバイス機能、ビジネス ロジック、構成設定、その他のランタイム条件など、アプリケーション固有の要因に基づく条件付き XAML シナリオが可能になります。

• WindowsAppSDK インストーラーがインストール中に進行状況を表示せず、ストールしているように見える問題を修正しました。 インストーラーにより、より明確な進行状況のフィードバックが提供されるようになりました。
• クラス ライブラリで WindowsAppSDKSelfContained が有効になっているシナリオのエラー処理が改善されました。
• プリプロセッサ定義をMSB8027ブロックからLNK4042に移動することによって、Windows アプリ SDK NuGet ClCompileファイル内の重複する.targetsアイテムによって発生する<Target>及び<ItemDefinitionGroup>ビルド警告を修正しました。 既知の MSVC 内部コンパイラ エラーを回避するために、ARM64EC + LTCG ビルドのオプトアウト回避策 (WindowsAppSDK_Arm64EcCompilerWorkaround) が含まれています。
• 項目リストの更新後にキーボード ナビゲーション (Tab/Shift + Tab) 中に発生する可能性がある ListView のクラッシュを修正しました。
• コントローラーが表示されていないときにフォーカスが CoreWebView2Controller に移動された場合に WinUI 3 がクラッシュする可能性がある問題を修正しました。
• DeleteIndex信頼性が向上し、一部のシナリオではERROR_SHARING_VIOLATIONで失敗しなくなりました (アプリ コンテンツ検索は試験段階のチャネルに残ります)。
• 一部の特殊なケースで負の値を返す光学文字認識 (OCR) 境界ボックスを修正しました。
• 同じプロセスで RegisterCertifiedAsync を再度呼び出すと 0 個の実行プロバイダー (EP) が誤って返されるWindows ML のバグを修正しました。

このリリースには、nuget 推移的な参照のリファクタリングが含まれています。 既存の C++ プロジェクトをアップグレードするには、ツール (nuget.exe またはVisual Studio) を使用して、既存のWindows アプリ SDK パッケージ参照を削除し、新しい参照を追加することをお勧めします。 これは、packages.configベースのプロジェクトに関するアップグレードの問題を回避します。

2.0 Experimental7 からのアップグレード。 試験的なMicrosoft.WindowsAppSDK.ML パッケージは、2.0.0 より高いパッチ番号で出荷され、NuGet ダウングレード エラー (特に C++ プロジェクト) として表示される可能性があります。 Experimental7 を使用していた場合は、 NuGet アンインストール ガイドに従って、2.0.0 を参照する前に実験用パッケージを削除してください。

• アプリ コンテンツ検索は試験段階のままです。 Microsoft.Windows.Search.AppContentIndex API サーフェイス (アプリ コンテンツ検索) は、基礎を改善し、将来の互換性を確保するために、2.0-Preview2 で削除されました。 2.0.1 安定版には含 まれません 。 実験するには、実験用リリースを引き続き使用します。 実験用 Microsoft.Windows.Search パッケージを以前にインストールした場合は、2.0.1 安定版に移行する前に、NuGet Uninstall ガイドを使用してアンインストールします。
• API は既に 1.8 サービスで出荷されています。 2.0 サイクル中にプレビューされた一部の試験的機能は、1.8 サービス リリースで安定した API に昇格されたため、2.0.1 では新しいものではありません。 これには、 ModelCatalog (1.8.3)、 TextRewriter.RewriteCustomAsync (1.8.4)、 SplitMenuFlyoutItem plus SplitMenuFlyoutItemAutomationPeer (1.8.6) が含まれます。 詳細については、 1.8 リリース ノート を参照してください。

• AICapabilities が 2.0.1 から見つかりません。 Microsoft.Windows.AI.AICapabilities と AICapabilityCategory.CopilotPlusPCCapable (Copilot+ PC 機能チェック) は 1.8.7 で出荷されましたが、2.0.1 にはなりませんでした。 5 月のリリースで復元する予定です。

このリリースには、安定版の 1.8.7 リリースと比較して、次の新しい API が含まれています。

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

Microsoft.WindowsAppSDK.ML NuGet パッケージがリファクタリングされ、新しい基本依存関係が追加されました。 既存の ML NuGet パッケージの機能は変わりませんが、コア Windows ML 機能は、Microsoft.Windows.AI.MachineLearning という基本依存パッケージにリファクタリングされています。 この新しいパッケージには最小限の依存関係セットが含まれていますが、C#/WinRT または C++/WinRT では、Windows 10 18362 までしかサポートされていません。 Windows 10 17763 のサポートが必要な場合は、既存の Microsoft.WindowsAppSDK.ML パッケージを使用します。

新しい推移的な依存関係の場合は、ツールを使用してパッケージ (nuget.exe または VS) をアップグレードすることをお勧めします。 「Windows アプリ SDK 1.6 リリース ノートも参照してください。

ONNX Runtime のバージョンが 1.24.4 に更新されました。 詳細については 、ONNX ランタイムのバージョン を参照してください。

制限付きアクセス機能の一部として Phi Silica API を適用しました。

AI モデルのインストール中にさまざまなネットワークエラーとWindows Updateエラーのチェックが追加され、ユーザーはモデル パッケージのインストールに失敗した理由を理解できるように永続的なエラーにフラグを設定しました。

Windows AI シナリオで使用されるテキスト インテリジェンス API の診断可能性が向上しました。

アプリ コンテンツ検索は 2.0 プレビューから削除されましたが、基礎となる AI モデルの変更に合うように基礎を改善し、将来の互換性を確保するために取り組みます。それまでは、実験用チャネルを引き続き使用して、最新の変更を試してください。

WinUI 3 アプリケーションでホストされている WebView2 コンテンツのドラッグ サポートを有効にしました。 この機能は以前はサポートされておらず、新しいパブリック API を導入せずに使用できるようになりました。 注: 外部ソースからの WebView2 へのドロップは既にサポートされています。

サポートされているシナリオ

• 標準のドラッグ アンド ドロップ コンテンツ テキスト、HTML、画像、URL のドラッグがサポートされています。 現在の動作に基づいて、アプリの外部でイメージをドラッグすると、エクスプローラーにドロップされると既定のファイル名 ( download.jpg など) になります。 シナリオの例: ユーザーが WebView2 内のテキストまたは画像を選択し、アプリ内またはエクスプローラーなどの別の宛先にドラッグします。

• ドラッグキャンセル アクティブなドラッグ操作のオンデマンドキャンセルがサポートされています。 シナリオの例: アプリは、特定のコンテンツ タイプ (制限付きコンテンツやエフェメラル コンテンツなど) のドラッグ操作を、開始後にドラッグを取り消すことによって条件付きでブロックします。

• カスタムドラッグビジュアル アイコンやプレビューなどのカスタム ドラッグ UI は、ユーザーがドラッグするコンテンツを明確に識別できるようにサポートされています。 シナリオの例: ユーザーがメディア コンテンツをドラッグすると、アプリにサムネイル プレビューまたはアイコンが表示され、現在移動中の項目が明確になります。

• カスタマイズ可能なドラッグ データ ドラッグ データの編集とカスタマイズがサポートされているため、アプリ内でメッセージをドラッグするなどのアプリ固有のシナリオが可能になります (たとえば、メッセージ転送の代替操作として)。 シナリオの例: アプリは、元のアプリケーション名などのコンテキスト メタデータを含むようにドラッグ ペイロードをカスタマイズします。 コンテンツが削除されると、移動先は "From <app name>" などの情報を表示または処理して、ドラッグされたコンテンツのソースを示すことができます。

制限事項

• 追加のドラッグ データ型のサポートは制限されています。 現在、次の形式はサポートされていません。
  • DownloadURL

必要条件

• 最小 WebView2 ランタイム バージョン (Edge ベータ チャネル): 144.0.3719.11

IXamlCondition インターフェイスを使用すると、開発者は XAML の条件付き名前空間構文と統合され、XAML 解析時に評価されるカスタム条件を定義できます。 これは、試験的な IXamlPredicate インターフェイスの名前変更と卒業です。 カスタム条件により、機能フラグ、デバイス機能、ビジネス ロジック、構成設定、その他のランタイム条件など、アプリケーション固有の要因に基づく条件付き XAML シナリオが可能になります。

• プリプロセッサ定義を <Target> ブロックから <ItemDefinitionGroup> に移動することで、Windows アプリ SDK NuGet .targets ファイル内の重複する ClCompile 項目によって発生するMSB8027とLNK4042ビルドの警告を修正しました。 既知の MSVC 内部コンパイラ エラーを回避するために、ARM64EC + LTCG ビルドのオプトアウト回避策 (WindowsAppSDK_Arm64EcCompilerWorkaround) が含まれています。
• 項目リストの更新後にキーボード ナビゲーション (Tab/Shift + Tab) 中に発生する可能性がある ListView のクラッシュを修正しました。
• コントローラーが表示されていない間にフォーカスが CoreWebView2Controller に移動された場合に WinUI 3 がクラッシュする問題を修正しました。

このリリースには、2.0-Preview1 と比較した次の新しい API と変更された API が含まれています。

Microsoft.UI.Xaml.Markup

    IXamlCondition

• Windows ML の ONNX ランタイムのバージョンが 1.24 RC に更新されました
• 同じプロセスで RegisterCertifiedAsync が再度呼び出されると、0 個の実行プロバイダー (EP) が誤って返されるバグを修正しました

• InputFocusController.ShouldShowKeyboardCuesの作成直後にキーボードキューを表示するかどうかを開発者に指示する新しいContentIslandプロパティ。
• 開発者が提供されたPointerPoint.GetCurrentPointからアクティブなPointerPoint データを取得できるようにするための新しい便利な API pointerId。

• DeleteIndexの信頼性が向上しました。 DeleteIndexがERROR_SHARING_VIOLATIONで失敗することがあります。

• 一部の特定のケースで負の値が返される OCR 境界ボックスを修正しました。

• アプリ コンテンツ検索は、Microsoft.Windows.Search の一部ではなく、個別の Microsoft.Windows.AI package パッケージの一部です。

• プレフィックス検索が短いクエリ文字列で動作しない問題を修正しました。

• 公式の API レビューに基づいて新しい API と名前を変更します。

  • AppContentIndexer
    • GetContentItemsRequiringReindexing
    • 削除 -> コンテンツアイテムを削除する
    • RemoveMultiple -> RemoveContentItems
    • すべてのコンテンツ項目を削除
    • GetContentIndexingStatus -> GetContentItemStatus
    • GetMultipleContentIndexingStatus -> GetContentItemStatuses
    • コンテンツアイテムを取得 (GetContentItems)
  • AppContentIndexListener
    • インデックスステータス変更 -> コンテンツアイテムステータス変更
  • AppIndexTextQuerySession
    • クエリを更新 -> クエリ更新フレーズ
    • 最新の結果 -> 結果を取得する
    • 最新の結果変更 -> 結果変更
  • AppIndexImageQuerySession
    • クエリを更新 -> クエリ更新フレーズ
    • 最新の結果 -> 結果を取得する
    • 最新の結果変更 -> 結果変更
  • AppManagedImageQueryMatch
    • サブリージョン -> 注目領域
  • ContentItemStatusResult
    • 再インデックス作成ステータス * コンテンツ項目再インデックス作成ステータス
  • テキストクエリセッション結果
    • IsValid
  • ImageQuerySessionResult
    • IsValid
  • クエリコンテンツアイテムフィルターフラグ

• WindowsAppSDK インストーラーがインストール中に進行状況を表示せず、ストールしているように見える問題を修正しました。 インストーラーにより、より明確な進行状況のフィードバックが提供されるようになりました。
• クラス ライブラリで WindowsAppSDKSelfContained が有効になっているシナリオのエラー処理が改善されました。

このリリースには、1.8.5 と比較した次の新規および変更された実験用 API が含まれています。

---

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

• 新しい AIComputeDevice API を使用すると、 TextRecognizer を作成するときに、アプリで既定の、CPU、または NPU 実行デバイスを選択できます。 ContentRegionImageOptions.PreferredTextRecognizerDevice は、アプリ コンテンツ インデックスイメージのインデックス作成中に実行される OCR に対して同じデバイス設定を提供します。
• AI Speech では、 SpeechRecognitionModelFactory と SpeechRecognitionModelFactoryOptions を使用して音声認識モデルを構成および作成できるようになりました。 オーディオ入力メソッドは、16 ビットのサンプル バッファーを受け入れるようになりました。継続的な認識は非同期的に停止し、ストリーミング認識イベントはプロバイダー固有のプロパティを公開します。
• LanguageModel.ModelName、 LanguageModel.ModelVersion、 LanguageModelLowRankAdapterStatus を使用すると、アプリはインストールされている言語モデルを識別し、低ランクアダプターを読み込むときに互換性の結果を検査できます。
• LanguageModelResponseStatus.BlockedByGameMode と LanguageModelResponseStatus.LowOnVram は、ゲーム モードがアクティブであったか、使用可能なビデオ メモリが不足しているために完了できなかった応答を識別します。

新しい実験用 FrameworkElement.SetThemeResourceBinding API を使用すると、アプリはコードから同等の {ThemeResource} バインディングを作成できます。 (RuntimeCompatibilityChange: WinUI_SetThemeResourceBinding)

新しい実験用 の DataTemplate コンストラクターは、テンプレートの要素サブツリーを作成するアプリ指定のデリゲートを受け入れます。 (RuntimeCompatibilityChange: WinUI_DataTemplateFromDelegate)

実験用 の TableView コントロールがパブリック WinMD で使用できるようになりました。 テンプレート化されたグループヘッダーによるグループ化、列ヘッダーの並べ替えインジケーターを使用した並べ替えとフィルター処理、ポインターおよびキーボードによる列のサイズ変更、ならびにセルと列ヘッダーに対するオプションのツールヒントをサポートします。 (RuntimeCompatibilityChange: TableView_TabularBinaryActivation)

このリリースでは、デカルト データを線、領域、および棒の系列として表示するための実験的な WinUI 3 グラフ コントロールが追加されました。 このコントロールは、構成可能な軸、凡例、データ ラベル、およびデータ マーカーをサポートしています。 (RuntimeCompatibilityChange: Charts_ExperimentalControlApi)

• InkPresenter.ActivateCustomDrying と InkSynchronizer が追加されました。これを使用すると、アプリは BeginDry と EndDry を使用してコミットされたインクを自身でレンダリングできます。
• カスタム乾燥がアクティブな間に InkPresenter.StrokeContainer を読み取るときに発生する可能性があるアクセス違反を修正しました。
• InkCanvas プレゼンターの、RenderTransform 下でのサイズ設定を修正しました。
• 試験段階の InkToolbar API をレビューされたデザインに合わせて調整しました。 ツール バーは InkCanvas を必要とせずに InkPresenter を直接ターゲットにするようになりました。 (ランタイム互換性の変更: InkCanvas_InkingSupport)

• アプリがビジュアル状態のストーリーボードを繰り返し作成したり、静的リソースまたはテーマ リソースを解決したりしたときにメモリ使用量が増加する可能性がある WinUI リソース追跡の問題を修正しました。 (RuntimeCompatibilityChange: WinUI_ResourceGraphExpiredDependencyPruning)
• タブまたはページの破棄後に、.NET アプリで到達できないネイティブ WinUI オブジェクトのクリーンアップが改善されました。 (RuntimeCompatibilityChange: WinUI_OrphanedObjectGCCollection)

このリリースには、 2.4 試験段階 のリリースと比較して、次の新しい API と更新された API が含まれています。

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

このリリースでは、ペンとタッチ入力、クリップボードのサポート、ハイ コントラスト サポート、ストローク入力、未処理の入力など、 InkCanvas、 InkToolbar、 InkPresenter を介した WinUI 3 の手描き入力サポートが追加されました。 (ランタイム互換性の変更: InkCanvas_InkingSupport)

このリリースには、 2.3 Experimental A リリースと比較した次の新しい API が含まれています。

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

新しい試験段階 の Window.Width プロパティと Window.Height プロパティを使用すると、 Windows.AppWindow を経由して手動で論理から物理 DPI 変換を実行することなく、コードまたはマークアップから直接論理 (クライアント) ピクセルでウィンドウのサイズを取得および設定するための DPI 対応の方法がアプリに提供されます。 Companion Window.MinWidth、 Window.MinHeight、 Window.MaxWidth、 Window.MaxHeight のプロパティは、ウィンドウのサイズを制限します。 皆様のご意見をお待ちしております。

試験段階の SpeechAudioProvider (16 kHz、16 ビット、シングル チャネル PCM オーディオを音声認識にプッシュするために使用) で IClosable が実装されるようになりました。これにより、アプリはオーディオのストリーミングが完了したときに 、Close/Dispose を使用してプロバイダーを確定的に解放できます。

試験段階のアプリ コンテンツ インデックス API は、このリリースで新しいインデックス作成機能と大幅な信頼性とパフォーマンスの向上を追加します。

• バッチ インデックス作成の高速化。 新しい AppContentIndexer.BatchAddOrUpdate API を使用すると、複数の項目のインデックスを一緒に作成できます。 インデックス作成パイプラインも、並列ステージ実行とより効率的なバッチ処理をサポートするように再設計されました。
• 多言語トークン化が改善されました。 アプリ コンテンツ インデックスで ICU ベースのワード ブレーカーが使用されるようになりました。これにより、WinRT WordsSegmenter への依存関係を削除しながら、言語間でのトークン化の正確性が向上しました。
• インデックス作成とクエリのパフォーマンスが向上しました。 インデックスの更新により、不要な字句の書き換え、バッチ クリーンアップ作業の効率が向上し、クエリ全体でインデックス機能がキャッシュされるようになり、一般的なクエリパスとインデックス作成パスのオーバーヘッドが大幅に削減されました。
• より安定した字句ランキング。 BM25 スコアリングでは、ドキュメントの長さの統計が個別に維持され、コンテンツが増分更新または削除されるときに一貫したランク付けが維持されるようになりました。
• 破損の自動回復。 アプリ コンテンツ インデックスは、インデックスを開くときにデータベースの破損と互換性のないスキーマの変更を検出し、インデックスを使用できないようにするのではなく、インデックス再作成を開始することによって自動的に回復します。 GetOrCreateIndexStatus.RecoveredFromCorruption は、復旧がいつ発生したかを示します。
• 静的ランキングの強化。 新しい API を使用すると、アプリは個々のコンテンツ項目またはリージョンにランク付けブーストを適用し、アプリケーションによって提供されるシグナルを使用して結果を偏らせることができるようにします。 静的ブーストは、コンテンツ自体によってキャプチャされないコンテンツの相対的な重要性に関する知識がある場合に使用します。たとえば、ユーザーが特に重要または一般的に求めているドキュメントを表示するのに役立ちます。
• 画像コンテンツのインデックス作成。 アプリは、OCR 抽出と抽出されたテキストのセマンティック インデックス作成を制御するオプションを使用して、ビットマップまたはイメージ ストリームのコンテンツに直接インデックスを付けることができるようになりました。 スクリーンショット、スキャンされたドキュメント、その他のビジュアル コンテンツなど、テキストとして既に使用できる情報ではなく、意味のある検索可能な情報が画像に含まれている場合は、画像のインデックス作成を使用します。
• テキストのセマンティック インデックス作成コントロール。 新しい ContentRegionTextOptions.AllowSemanticIndexing プロパティを 使用すると、アプリはセマンティック インデックス作成から個々のテキスト領域を選択できます。 これは、検索可能な字句を維持する必要があるテキストに便利ですが、セマンティック マッチングのメリットを得る可能性は低く、アプリでセマンティック検索に参加するコンテンツをより詳細に制御できます。

このリリースには、 2.2 Experimental 9 リリースと比較した次の新しい API が含まれています。

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

言語モデル API は、サポートされている GPU を備えた非Copilot+ PCsで実行されるようになり、ローカル言語モデルの機能がより広範なWindows 11 デバイスに提供されるようになりました。 サポートされているハードウェアには、NVIDIA GeForce RTX 30 シリーズ以降と 6 GB 以上の vRAM が含まれます。 GPU 推論では、開発者モードを有効にし、Windows Insider Experimental Channel をビルドする必要があります。

GPU モデルはプレインストールされていません。 Windows Updateを通じて、EnsureReadyAsync 経由でオンデマンドでダウンロードされます。 アプリでは、ダウンロードをトリガーする前に、 GetReadyState を確認し、同意ダイアログを表示する必要があります。 ユーザーは、システム > AI コンポーネント>設定でモデルを管理できます。

責任ある AI に関するガイダンスについては、新しい透明性に関する注記「Copilot+ PC ではない PC 上の言語モデル API」を参照してください。

Microsoft.Windows.AI.Speech の新しいデバイス上の音声認識 API により、音声テキスト変換のバッチ処理とストリーミングの両方が可能になります。 BatchRecognition は、1 回の呼び出しで完全なオーディオ ソースを認識し、 StreamingRecognition は Recognizing イベントと Recognized イベントを発生させます。 オーディオは、デバイス (AudioConfiguration.FromAudioDevice)、ファイル (FromFile)、入力ストリーム (FromStream)、または SpeechAudioProvider (16 kHz、16 ビット、シングルチャネル PCM) を介して呼び出し元によってプッシュされます。 デバイス上のモデルは SpeechRecognitionModel.EnsureReadyAsync / TryCreateAsyncを介して管理され、ダウンロードと読み込みの進行状況は SpeechRecognitionModelProgressによって報告されます。

新しい Microsoft.Windows.Workloads.NpuType 列挙型は、現在のデバイス上の NPU クラスを表示します (例: Qnn、Lnl、Stx、Win365、Unknown、None)、アプリとワークロードインフラストラクチャが AI ワークロードを適切な実行パスにルーティングできるようにします。

このリリースには、 2.1 Experimental 8 リリースと比較した次の新しい API が含まれています。

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(2.0 Experimental 7 で導入) は、ジェネリック GenerateStructuredJsonResponseResultGenerateStructuredJsonResponseStatusLanguageModelResponseResult ペアではなく、 / プロパティを持つ専用のLanguageModelResponseStatus型を返すようになりました。 新しい状態列挙型は、スキーマ制約のある生成に固有です。これには、モデルの出力が要求された JSON スキーマを満たしていない場合の ResponseInvalidJson 値が含まれます。これは、汎用言語モデルの応答エラーとは別です。

この分割の一環として、安定したResponseInvalidJson列挙型 (構造化された JSON 出力をサポートするために以前に追加された) から値がLanguageModelResponseStatusされました。 ResponseInvalidJsonからLanguageModelResponseStatusを処理したアプリは、その処理を、GenerateStructuredJsonResponseStatusによって返される新しいGenerateStructuredJsonResponseAsyncに移動する必要があります。 LanguageModelResponseStatusの他の呼び出し元は、JSON 固有のエラー値を考慮する必要がなくなりました。

このリリースには、 2.0 Experimental 7 リリースと比較した次の新しい API が含まれています。

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]

Windows アプリ SDK 2.0.0-experimental7 では、C++ 開発者が CMake ベースのプロジェクトから nuGet パッケージWindows アプリ SDK使用できるように、試験的な CMake サポートが導入されています (開発中)。

CMake 統合は、NuGet パッケージ管理と CMake のネイティブ ワークフローのギャップを埋めるオープンソースの CMake モジュールである find_package() 上に構築されています。 NuGetCMakePackage は、 add_nuget_packages()を使用して構成時に NuGet パッケージのダウンロードと復元を処理し、埋め込まれた cmake 構成の各パッケージをプローブし ( build/cmake/<package>-config.cmake)、パッケージのヘッダー、インポート ライブラリ、ランタイム DLL、WinRT メタデータを標準の CMake ターゲットとして公開します。

各Windows アプリ SDK NuGet コンポーネントと依存パッケージは、build/cmake/ の下に CMake 構成ファイルを埋め込むようになりました。CMake の find_package() では、手動パス構成なしでターゲット、ヘッダー、ライブラリ、ランタイム DLL を自動的に検出できます。 これには、Foundation、InteractiveExperiences、DWrite、Widgets、AI、ML、WinUI などのすべてのコンポーネント パッケージと、Base や Runtime などの依存関係が含まれます。

CMake の使用モデルと入門ガイダンスの概要については、 CMake のランディング ページを参照してください。

この機能は試験的であり、コミュニティのフィードバックを収集するために初期段階で段階的にリリースされています。 ターゲットの名前付け規則と構成パターンは、開発者の入力に基づいて変更される可能性があります。 これは初期のフライトであるため、いくつかの儀式とセットアップが関係しています。4 つの展開シナリオ ( x SelfContained|FrameworkDependent) 全体のエンド ツー エンドの構成と使用方法を示す Packaged|Unpackagedを参照してください。

ご意見をお聞かせください 現在取り上げられていないシナリオが発生した場合、開発者エクスペリエンスを改善するための提案がある場合、または問題が発生した場合は、Windows アプリ SDKオープンソース リポジトリの Issues タブにフィードバックを送信するか、Discussions で会話を開始してください。 あなたの入力は、この機能の主体的な開発に直接影響を及ぼします。

この試験的リリースでは、2.0-Preview1 および 2.0-Preview2 に含まれる変更と修正がまとめられています。 今後の項目の概要を以下に示します。詳細については、リンクされたプレビューリリース ノートを参照してください。

2.0-Preview1 から:

• Windows ML: RegisterCertifiedAsyncが同じプロセスで再度呼び出されたときに 0 個の実行プロバイダーを返す問題を修正しました。
• Microsoft。Ui。Content: 新しい InputFocusController.ShouldShowKeyboardCues プロパティと新しい便利な API PointerPoint.GetCurrentPoint。
• Microsoft.Windows.Management.Deployment: Windows.Management.Deployment (AddAsync、GetDefault、GetAvailableSpaceAsync、IsAppxInstallSupported、IsOffline、IsFeatureSupported などを含む) と関するパリティ + の新しい PackageVolume API。 IPackageValidatorとAddPackageOptionsに新しい拡張性ポイントがあり、StagePackageOptions、PackageCertificateEkuValidator、およびPackageFamilyNameValidatorの3つの組み込み検証ツールが備わっています。
• Microsoft.Windows.Storage.Pickers:
  • カスタム ダイアログ タイトルを有効にする、Title、FileOpenPicker、およびFileSavePickerの新しいFolderPickerプロパティ。
  • SettingsIdentifier、FileOpenPicker、およびFileSavePickerの新しいFolderPickerプロパティにより、セッション間でピッカー インスタンス固有の状態が有効になります。
  • InitialFileTypeIndexとFileOpenPickerの新しいFileSavePickerプロパティを使用すると、開発者はインデックス (0 ベース) で既定で選択したファイルの種類のフィルターを設定できます。
  • ShowOverwritePromptの新しいFileSavePicker プロパティ。 既定では true され、ユーザーが FileSavePickerを介して既存のファイルを選択したときに、ピッカーで上書きに関する警告が表示されるかどうかを制御します。
  • FileSavePickerの既定の動作を変更しました。WindowsAppSDK 2.0 以降では、ユーザーが既存のファイルを選択したときに、FileSavePickerは空のファイルを作成せず、開発者はファイルを作成するタイミングを決定できます。
  • PickMultipleFoldersAsyncの新しいFolderPickerメソッド。1 回の操作で複数のフォルダーを選択できます。
• バグ修正: インストーラーの進行状況レポート。 WindowsAppSDKSelfContained クラス ライブラリのエラー処理が改善されました。

2.0-Preview2 から:

• Windows AI API: Phi Silica API は制限付きアクセス機能として適用されます。新しい AIFeatureReadyState 値は、不足している機能、互換性のないハードウェア、必要な OS 更新プログラムなどのモデル取得の問題を解決します。永続的なネットワーク/Windows Updateインストール エラーにフラグが設定され、テキスト インテリジェンス API の診断可能性が向上しました。
• カスタム XAML 条件: IXamlCondition は実験用の IXamlPredicate インターフェイスを卒業して名前を変更し、XAML 解析時にカスタム条件を評価できるようにします。
• WebView2 (WinUI 3): WebView2 でホストされているコンテンツ (テキスト、HTML、画像、URL)、ドラッグキャンセル、カスタム ドラッグ ビジュアル、およびカスタマイズ可能なドラッグ データのドラッグ サポート。 WebView2 Runtime 144.0.3719.11 以降が必要です。 (DownloadURL はまだサポートされていません。
• バグ修正: MSB8027/LNK4042 .targets ファイル内の重複する ClCompile 項目からのビルド警告 (ARM64EC+ LTCG のオプトアウト回避策 WindowsAppSDK_Arm64EcCompilerWorkaround )項目リストの更新後にキーボード ナビゲーション中に ListView がクラッシュする。非表示の CoreWebView2Controller にフォーカスが移動すると、WinUI 3 がクラッシュします。

• わかりやすく一貫性を保つための API の名前変更パス:
  • ScaleFrameStatus → VideoScalerStatus
  • VideoScalerOptions.RegionOfInterests → VideoScalerOptions.RegionsOfInterest
  • VideoScaler.ScaleFrame → VideoScaler.Scale と VideoScaler.ScaleImageBuffer
• VSR のさまざまなバグ修正と品質の向上。

• 言語モデルから構造化された JSON 出力を生成するための、LanguageModelExperimental.GenerateStructuredJsonResponseAsync の新しい Microsoft.Windows.AI.Text.Experimental API。
• モデルが有効な JSON として解析されなかった応答を返したことを示す新しい LanguageModelResponseStatus.ResponseInvalidJson 状態値。

• 新しい AppContentIndexer.GetExistingIndexes API と AppContentIndexer.IsContentKindSupported API。
• OCR から派生したテキストを使用したアプリ コンテンツのクエリをサポートする新しい AppManagedOcrTextQueryMatch の種類と QueryMatchContentKind.AppManagedOcrText 値。
• 新しいインデックスの作成を強制する新しい GetOrCreateIndexOptions.CreateAlways 。
• インデックス作成中にディスク空き容量不足の問題を可視化する新しい ContentItemErrorDetail.InsufficientDiskSpace があります。

このリリースには、2.0.0-experimental6 と比較した次の新規および変更された試験的 API が含まれています。

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 は、CMake を使用して C++ プロジェクトから使用できるようになりました。 詳細については、「 はじめに」ページ を参照してください。

ONNX Runtime のバージョンが 1.24.2 に更新されました。 詳細については 、ONNX ランタイムのバージョン を参照してください。

• NPUPowerMode は、新しい電源管理 API を優先して非推奨になりました。
• GetReadyState では、セッション ブローカーが使用できないときに、例外をスローするのではなく、NotSupported をスムーズに返すようになりました。

• ビデオスーパー解像度のNV12出力フォーマットのサポートを追加しました。

• DeleteIndexの信頼性が向上しました。 DeleteIndexがERROR_SHARING_VIOLATIONで失敗することがあります。

• 一部の特定のケースで負の値が返される OCR 境界ボックスを修正しました。

• アプリ コンテンツ検索は、Microsoft.Windows.Search の一部ではなく、個別の Microsoft.Windows.AI package パッケージの一部です。

• プレフィックス検索が短いクエリ文字列で動作しない問題を修正しました。

• 公式の API レビューに基づいて新しい API と名前を変更します。

  • AppContentIndexer
    • GetContentItemsRequiringReindexing
    • 削除 -> コンテンツアイテムを削除する
    • RemoveMultiple -> RemoveContentItems
    • すべてのコンテンツ項目を削除
    • GetContentIndexingStatus -> GetContentItemStatus
    • GetMultipleContentIndexingStatus -> GetContentItemStatuses
    • コンテンツアイテムを取得 (GetContentItems)
  • AppCOntentIndexListener
    • インデックスステータス変更 -> コンテンツアイテムステータス変更
  • AppIndexTextQuerySession
    • クエリを更新 -> クエリ更新フレーズ
    • 最新の結果 -> 結果を取得する
    • 最新の結果変更 -> 結果変更
  • AppIndexImageQuerySession
    • クエリを更新 -> クエリ更新フレーズ
    • 最新の結果 -> 結果を取得する
    • 最新の結果変更 -> 結果変更
  • AppManagedImageQueryMatch
    • サブリージョン -> 注目領域
  • ContentItemStatusResult
    • 再インデックス作成ステータス * コンテンツ項目再インデックス作成ステータス
  • テキストクエリセッション結果
    • IsValid
  • ImageQuerySessionResult
    • IsValid
  • クエリコンテンツアイテムフィルターフラグ

• レースコンディションによりImageDescription.DescribeAsyncで発生するInternalErrorの失敗を修正しました。

このリリースには、2.0.0-experimental5 と比較した次の新規および変更された試験的 API が含まれています。

Microsoft.Windows.Search.AppContentIndex

    AppContentIndexer
        GetContentItems
        GetContentItemStatus
        GetContentItemStatuses
        RemoveAllContentItems
        RemoveContentItem
        RemoveContentItems

    AppContentIndexListener
        ContentItemStatusChanged

    AppManagedImageQueryMatch
    ContentItemErrorDetail
        IndexCorruption

    ContentItemReindexingStatus
        Unspecified

    QueryContentItemsFilterFlags

• WINDOWS ML を使用してアプリケーションを構築する ISV の明確な条件により、簡略化された使用許諾契約書。
• インストール、データ、および再頒布可能コードをわかりやすく説明する再構築されたセクション。
• 新しい実行プロバイダー (EP) のコンプライアンスに関する通知セクションでは、ハードウェア高速化実行プロバイダーに関する開発者の責任について説明します。
• NVIDIA TensorRT、Intel OpenVINO、Qualcomm QNN (Qualcomm Neural Network SDK) のベンダー ライセンス契約への直接リンク。

• Windows ML の試験的ビルドは、互換性と安定性を向上させるために、ONNX Runtime メインライン バージョン 1.24 と一致します。
• 安定したアプリケーション バイナリ インターフェイス (ABI) 実行プロバイダーは、デバイス間で予測可能な動作を保証するために適用され、非安定実行プロバイダーは取得から除外されます。
  • OpenVINO 実行プロバイダーのみがサポートされており、安定性の要件を満たしているため、追加の実行プロバイダーが時間の経過と共に追加されます。
• Microsoft.Windows.AI.MachineLearning.dllのサイズは約 160 KB 削減されました。

• インデックスが作成されている項目の統計を参照するための新しい試験的 API。 これにより、インデックスで何が起こっているかを把握できます。
• 現在のクエリが完了する前に新しいクエリがある場合に、アプリがクエリを実行して更新できるようにするクエリの取り消しのサポート。 これにより、ユーザーがクエリ文字列に入力すると、クエリに対する応答が速くなります。
• ユーザーが入力する際の結果を改善するために、短い文字列のプレフィックス一致のサポート。

• VideoScaler が使い捨てになり、リソース管理とライフサイクル制御が向上しました。
• VSR モデルがコンパイルされ、キャッシュされ、パフォーマンスが向上し、初期化の繰り返しコストが削減されました。
• 使用する前に、VSR のサポートを検証するための機能チェックが追加されました。
• ビデオスーパー解像度を使用する場合、明示的な WinML 初期化は不要になりました。

• FlowLayout コントロールでは、水平方向と垂直方向の間隔のプロパティではなく、ItemSpacing と LineSpacing の用語が使用されるようになりました。 アラインされた名前付けにより、UI フレームワーク全体の最新のレイアウト パターンとの明確さと一貫性が向上します。

• WrapPanel コントロールでは、前の水平および垂直方向の間隔プロパティではなく、ItemSpacing および LineSpacing の命名法が使用されるようになりました。

• XAML の条件付き名前空間構文とシームレスに統合され、XAML 解析時に評価されるカスタム述語を定義するために、 IXamlPredicate インターフェイスを実装しました。
• カスタム述語では、次のようなアプリケーション固有の要因に基づいて、条件付き XAML シナリオを有効にします。
  • 機能フラグ
  • デバイスの機能
  • ビジネス ロジック
  • 構成設定
  • その他のランタイム条件

• 外部ユーザビリティを有効にするようにパッケージを更新しました。これには、次の変更が含まれます。
  • Microsoft.UI.DCPP.Dependencies.Minimal
  • Microsoft.UI.DCPP.Dependencies.Edge
  • ExpPointerPointStatics
• Visual Studio 2026 のビルド サポートを追加しました
• 外部開発者が WinUI をビルドおよびテストするために使用するツールとスクリプトを導入しました。

• [非推奨]「DependencyObject.Dispatcher」
• [非推奨]Window.Current
• [非推奨]FocusManager.GetFocusedElement
• [renamed]SystemBackdropHost を SystemBackdropElement に変更しました

• [renamed] Microsoft.Windows.AI.Search.Experimental.AppContentIndex を Microsoft.Windows.Search.AppContentIndex に変更しました

• Windows ML で自己完結型デプロイを使用する場合の "Class not registered" エラーを修正しました。 自己完結型展開を使用する開発者は、内部で使用されていた Foundation パッケージのアクティブ化可能なクラスをすべて登録する必要がなくなりました。
• Windows ML を使用しているときにプロセスのシャットダウン時に発生する可能性があるクラッシュを修正しました。
• 呼び出しが正しいエンドポイントに到達するように、 ImageForegroundExtractor API ルーティング パスを修正しました。
• パッケージの展開中に、実行プロバイダーのインストールとダウンロードの進行状況がアプリに正しく転送されるようにします。
• 無効な切断パスを保護してターゲットが切断された場合の SystemBackdrop のクラッシュを修正しました。
• 一部のアプリケーションでWindows AI API を使用できない問題を修正しました。

このリリースには、2.0.0-experimental3 と比較した次の新しい実験用 API と変更された実験用 API が含まれています。

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 ランタイムの回帰により、Qualcomm デバイスで Video Super Resolution が失敗します。 この問題は、Qualcomm NPU 実行プロバイダーに対する保留中の更新によって解決されます。

新しい試験的な SplitMenuFlyoutItem コントロールは、メニュー ポップアップ内で分割ボタン エクスペリエンスを提供するように設計されています。 このコントロールを使用すると、開発者は既定のプライマリ アクションを公開しながら、サブメニューを介して追加のオプションを提供できます。これは、複雑な機能をより小さなフットプリントに凝縮し、メニュー全体の長さを節約するのに最適です。

MenuFlyoutItem と MenuFlyoutSubItem の機能に加えて、このコントロールには他に 2 つのプロパティ ( 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 では、インスタンスの作成時に実行プロバイダー (IP) の一覧が返されるようになりました。
• Windows 10 (1809) 以降のサポートが追加されました。
• 通常のファイルと MSIX パッケージの両方を含むローカル ファイルのサポートを追加しました。
• 無効なカタログ JSON が原因で発生するクラッシュを修正しました。

• AppIndexQueryメソッドとGetNextTextMatchesメソッドを含む前のGetNextImageMatches型は、AppIndexTextQueryとAppIndexImageQueryの 2 つの異なる型に分割されています。 AppContentIndexer.CreateQueryメソッドは、CreateTextQueryとCreateImageQueryに置き換えられました。

• これらのメソッドは、それぞれ AppIndexTextQuery と AppIndexImageQuery を返すようになりました。 使用を簡略化するために、オプションの種類も更新されています。

  • 削除: AppIndexQueryOptions、 TextMatchOptions 、 ImageMatchOptions
  • 追加: TextQueryOptions と ImageQueryOptions

• 以前に配列を返した AppContentIndex 名前空間の API は、一貫性とパフォーマンスを向上させるために IVectorView を返すようになりました。

• AppContentIndexer.WaitForIndexingIdleAsync メソッドは、整数ではなくTimeSpan パラメーターを受け入れるように更新され、より明確で柔軟なタイムアウト処理を提供します。

VideoScaler API は、会話中のユーザーを特徴とするストリーム用に最適化された高度な AI アップスケーリングを通じて、リアルタイムのビデオ強化を実現します。 これにより、開発者は、ネットワークの状態が悪い場合でも、会議、ストリーミング、編集プラットフォーム全体で、より鮮明で明確なビジュアルを提供できます。 この API では、BGR、RGB、NV12 などの複数のビデオ形式との互換性を備えた、出力解像度、フレーム レート、関心領域のカスタマイズがサポートされています。

新しい RewriteCustomAsync API を使用すると、選択したテキストを書き換える際に Phi Silica をガイドする入力文字列を提供できます。 「グーフィー」や「海賊」などの新しいクリエイティブスタイルを試して、コンテンツを即座に変換することができます。

ImageGenerator クラスは、安定拡散モデルを利用して、強力な画像生成機能を提供します。 複数の生成シナリオがサポートされています。

• テキストからイメージへ: 説明テキスト プロンプトから画像を生成します。

• Image-to-Image: テキストの説明に基づいて既存の画像を変換します。

• マジックフィル: 画像のマスクされた領域に AI によって生成されたコンテンツを埋めます。

• 塗り絵スタイル: 塗り絵風の画像を生成する。

• 再スタイル: 構造を維持しながら、既存の画像のアート スタイルを変更します。

生成されたすべてのイメージは、ImageBuffer オブジェクトを介して RGB8 形式で返されます。 この 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");
    }
}

このリリースには、2.0-experimental2 と比較した次の新規および変更された試験的 API が含まれています。

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 テキスト 照合で、テキストが回転されたときに不正確または空の領域境界が報告されました。

AppContentIndexer API を使用すると、開発者は、テキストや画像を含むアプリ コンテンツのインデックスを効率的に作成して、迅速かつ関連性の高い取得を実現できます。 これらの API では、字句 (キーワードベース) 検索とセマンティック (意味ベース) 検索の両方をサポートすることで、正確なキーワードではなく、ユーザーの意図とコンテキストに基づいて、アプリが高速で関連性の高い結果を提供できます。

この機能により、次の高度なシナリオのロックが解除されます。

• セマンティック検索
  アプリは、正確なキーワードの一致ではなく、意図と意味に基づいて結果を返すことができます。
  例："プロジェクト タイムライン" のクエリでは、正確な単語が使用されていない場合でも、"スケジュール" または "配信日" に言及するコンテンツを表示できます。
• 検索拡張生成（RAG)
  インデックス付きコンテンツは、生成 AI モデルのナレッジ ベースとして機能できます。 ユーザーが質問をすると、アプリはインデックスから最も関連性の高いドキュメントまたはスニペットを取得し、モデルにフィードすることで、実際のデータに埋め込まれた正確でコンテキストに対応した応答を可能にします。

Windows ML モデル カタログ API を使用すると、アプリまたはライブラリは、独自のオンライン モデル カタログから大規模な AI モデル ファイルを動的に検出してダウンロードできるため、これらの大きなファイルをアプリまたはライブラリに直接パッケージ化する必要がなくなります。 モデル カタログは、モデルをフィルター処理し、使用中の特定のWindows デバイスに該当するもののみをダウンロードすることで、デバイスの互換性を確保するのに役立ちます。

最新の Microsoft.Windows.Storage.Pickers 更新プログラムは、開発者が初期および永続的なフォルダーの場所を設定できるようにし、ファイルの種類フィルターを明確なラベルでグループ化してナビゲーションを容易にすることで、ファイルとフォルダーの選択を効率化します。

PopupAnchor API を使用すると、DesktopPopupSiteBridge独自のウィンドウまたはアイランドに固定して相対位置をサポートできるようになりました。ポップアップは画面座標を使用してのみ絶対に配置できる制限に対処できます。

InputUnderlyingWindowController API を使用すると、開発者は、SystemVisual から作成された ContentIsland に最初に送信された入力メッセージを受信するためのターゲット HWND を指定できます (ContentIsland.CreateForSystemVisual を参照)。

SystemBackdropHost を使用すると、アプリケーションのビジュアル ツリー内の任意の場所にシステム背景 (アクリル/マイカ) を配置できます。

WrapPanelは WinUI XAML レイアウト パネルで、子要素を左から右に順番に配置します。行をオーバーフローした項目は、含まれているパネルの末尾で自動的に次の行に分割されます。 応答性の高いレイアウトに役立ちます。

これは、既存の Windows Community Toolkit コントロールのポートです。

このリリースには、2.0-experimental1 と比較した次の新規および変更された試験的 API が含まれています。

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 は、バックグラウンド スレッドから呼び出す必要があります。 UI スレッドで使用すると、ハングしたり、ユーザー エクスペリエンスに影響を与える長時間の一時停止が発生したりする可能性があります。
• AppIndexQuery.GetNextTextMatchesとAppIndexQuery.GetNextImageMatchesを使用したクエリ結果は、空のリストではなく一致するものがない場合は null になります。
• OCR 値に基づく AppManagedImageQueryMatch.Subregion を使用した画像の一致は、特にテキストが回転または傾斜している場合に不正確になる場合があります。
• AppManagedImageQueryMatch.Subregionを使用した画像の一致には、サイズが 0 または非常に小さい四角形が含まれる場合があり、結果が不正確になる場合があります。
• AppContentIndex.CreateQuery から空のクエリを実行すると、例外がスローされる可能性があります。

Windows ML モデル カタログ API を使用すると、アプリまたはライブラリで大きなファイルを直接アプリまたはライブラリに発送することなく、大規模な AI モデル ファイルを独自のオンライン モデル カタログから動的にダウンロードできます。 さらに、モデル カタログは、実行されているWindows デバイスと互換性のあるモデルをフィルター処理し、適切なモデルがデバイスにダウンロードされるようにするのに役立ちます。

主な利点:

• カタログの追加: 1 つまたは複数のオンライン カタログを追加する
• 互換性のあるモデルの検出: ユーザーのハードウェアおよび実行プロバイダーで動作するモデルを自動的に検索する
• モデルのダウンロード: さまざまなソースからモデルをダウンロードして格納する
• アプリ間でモデルを共有する: 複数のアプリケーションが同じカタログ ソースを使用している場合、ダウンロードを複製することなく、モデルがディスク上で共有されます

• DeploymentManager で PackageInstallRequired が誤って報告される問題を修正しました。

このリリースには、次の新しい実験用 API と変更された実験用 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