HoloLens2 OpenXR集成WebView2：初始化崩溃与控制器选型问题

控制器选择：CoreWebView2Controller 还是 CoreWebView2CompositionController？ #

• CoreWebView2Controller：绑定传统Win32窗口句柄（HWND），适合基于Windows窗口框架的UI集成，WebView2的渲染和交互由系统窗口管理。
• CoreWebView2CompositionController：基于DirectComposition，输出独立的可视化合成对象，无需依赖HWND，适合自定义渲染管线（如DirectX、OpenXR）场景。

针对OpenXR场景：OpenXR在HoloLens2上依赖DirectX渲染管线，不属于Windows原生UI框架，因此优先选用CoreWebView2CompositionController。它能将WebView2的渲染内容作为合成层嵌入到OpenXR的3D场景中，避免HWND窗口带来的布局和渲染冲突。

初始化崩溃（"Procedure is not found"）问题排查与修复 #

1. 依赖版本匹配 #

• 确认vcpkg安装的WebView2开发包版本与HoloLens2上的WebView2 Runtime版本完全兼容。"Procedure is not found"通常是因为编译时使用了高版本API，而设备上Runtime版本过低不支持该函数。建议同步升级设备上的WebView2 Runtime，或降级vcpkg的WebView2包版本到与Runtime匹配。
• 打包时务必使用ARM64架构的WebView2Loader.dll和Microsoft.Web.WebView2.Core.dll，且两个文件版本必须一致，避免加载时的版本冲突。

2. 初始化线程与时机 #

• WebView2的初始化必须在UI线程执行。OpenXR应用的渲染线程与UI线程分离，需将WebView2创建逻辑通过CoreDispatcher.RunAsync调度到CoreWindow的UI线程，避免跨线程调用导致的崩溃。
• 若使用CompositionController，无需传入HWND，直接通过CreateCoreWebView2CompositionControllerAsync创建，避开HWND有效性问题。

3. 修正初始化流程 #

示例（CompositionController初始化）：

// 确保在UI线程执行此逻辑
winrt::com_ptr<ICoreWebView2Environment> env;
HRESULT hr = CreateCoreWebView2EnvironmentWithOptions(
    nullptr, nullptr, nullptr,
    Callback<ICoreWebView2CreateCoreWebView2EnvironmentCompletedHandler>(
        [](HRESULT result, ICoreWebView2Environment* env) -> HRESULT {
            if (SUCCEEDED(result)) {
                env->CreateCoreWebView2CompositionControllerAsync(
                    nullptr,
                    Callback<ICoreWebView2CreateCoreWebView2CompositionControllerCompletedHandler>(
                        [](HRESULT result, ICoreWebView2CompositionController* controller) -> HRESULT {
                            if (SUCCEEDED(result)) {
                                // 获取CoreWebView2实例并配置
                                winrt::com_ptr<ICoreWebView2> webview;
                                controller->get_CoreWebView2(&webview);
                                webview->put_Source(L"https://example.com");

                                // 获取合成视觉对象，后续整合到OpenXR渲染管线
                                winrt::com_ptr<ICoreWebView2CompositionController2> controller2;
                                if (SUCCEEDED(controller->QueryInterface(IID_PPV_ARGS(&controller2)))) {
                                    winrt::com_ptr<IDCompositionVisual> rootVisual;
                                    controller2->get_RootVisual(&rootVisual);
                                    // 将rootVisual添加到DirectComposition层，再关联到OpenXR的3D场景中
                                }
                            }
                            return S_OK;
                        }).Get());
            }
            return S_OK;
        }).Get());

4. 打包与权限配置 #

• 在UWP应用清单中添加internetClient权限（加载外部网页时）或privateNetworkClientServer权限（加载本地资源时），避免WebView2因权限不足无法初始化。
• 检查打包配置，确保vcpkg中的WebView2依赖文件（包括资源文件）被完整包含到应用包中，缺失资源可能导致初始化失败。

5. 崩溃日志定位 #

通过Visual Studio的HoloLens2设备调试功能，捕获崩溃时的完整调用栈，找到"Procedure is not found"对应的具体函数名，这能直接定位是哪个API不兼容，快速调整版本或代码。

内容的提问来源于stack exchange，提问作者Larry Aultman