Unity-WebView插件在iOS平台实现早期JavaScript事件捕获的技术方案

背景介绍

在Unity开发中，WebView插件是连接原生网页内容与Unity应用的重要桥梁。许多开发者需要实现网页与Unity应用的双向通信，特别是在页面加载初期就能捕获JavaScript事件。然而，在iOS平台上，由于WebView的特殊性，这一需求往往面临挑战。

问题分析

开发者在使用unity-webview插件时发现，在Unity编辑器中可以正常工作的JavaScript事件捕获机制，在iOS真机设备上却无法正常获取页面加载初期的JavaScript事件。这是因为：

1. iOS平台的WebView实现机制与编辑器不同
2. 默认情况下JavaScript注入时机较晚（在页面加载完成后）
3. 页面加载初期触发的重要事件因此丢失

技术解决方案

1. 修改JavaScript注入时机

iOS平台的WebView提供了两种主要的脚本注入时机：

• WKUserScriptInjectionTimeAtDocumentEnd：文档加载完成后注入（默认）
• WKUserScriptInjectionTimeAtDocumentStart：文档开始加载时注入

将注入时机改为AtDocumentStart可以确保脚本在页面加载初期就可用。

2. 优化JavaScript桥接代码

正确的JavaScript桥接实现应避免递归调用，建议采用以下结构：

function myPostMessage(msg) {
    try {
        window.webkit.messageHandlers.unityControl.postMessage(msg);
    } catch(e) {
        console.error('Failed to send message to Unity:', e);
    }
}

3. 核心代码修改

在WebView.mm文件中，需要修改脚本注入部分：

// 修改注入时机为文档开始
WKUserScriptInjectionTime injectionTime = WKUserScriptInjectionTimeAtDocumentStart;

// 添加早期事件监听代码
str = [str stringByAppendingString:@"\
window._oktoMsgCache = []; \
window.addEventListener('message', function(event) { \
    try { \
        if (event && event.data && event.data.source === 'okto_web') { \
            window.Unity.call(JSON.stringify(event.data)); \
        } else { \
            window._oktoMsgCache.push(event); \
        } \
    } catch (e) { \
        console.error('Error forwarding message to Unity:', e); \
    } \
}); \
window.Unity.call(JSON.stringify({ type: 'test', message: 'Bridge initialized early' })); \
"];

实现效果

通过上述修改，可以实现：

1. 在iOS设备上捕获页面加载初期的所有JavaScript事件
2. 确保通信桥接在页面开始加载时就已建立
3. 保持与Unity编辑器一致的行为表现

注意事项

1. 早期注入的脚本应尽量精简，避免影响页面加载性能
2. 需要处理可能的消息缓存机制，防止事件丢失
3. 测试不同iOS版本和设备的兼容性
4. 考虑错误处理机制，确保通信稳定性

总结

通过调整unity-webview插件的JavaScript注入时机和优化桥接代码，开发者可以成功在iOS平台上实现早期JavaScript事件的捕获。这一技术方案解决了网页与Unity应用在iOS平台上的早期通信问题，为需要实时交互的应用场景提供了可靠的技术支持。