# sdk-webview

XuqmGroup Android SDK WebView 模块。提供嵌入式 WebView 组件和独立页面，内置 JSBridge、文件选择、下载拦截。

## 依赖

```kotlin
implementation("com.xuqm:sdk-webview:VERSION")
implementation("com.xuqm:sdk-core:VERSION")  // 必须
```

## 使用

### 嵌入式组件

```kotlin
import com.xuqm.sdk.webview.XWebViewView
import com.xuqm.sdk.webview.XWebViewConfig

XWebViewView(
    config = XWebViewConfig(
        url = "https://example.com",
        title = "嵌入式网页",
    ),
)
```

### 独立页面

```kotlin
import com.xuqm.sdk.webview.openXWebView
import com.xuqm.sdk.webview.XWebViewConfig

openXWebView(XWebViewConfig(url = "https://example.com", title = "独立页面"))
// navigate("xwebview") 后使用 XWebViewScreen()
```

## XWebViewConfig 参数

| 参数 | 类型 | 默认值 | 说明 |
|------|------|--------|------|
| `url` | String | `""` | 初始加载地址 |
| `title` | String | `""` | 页面标题 |
| `hideToolbar` | Boolean | `false` | 隐藏顶栏 |
| `hideStatusBar` | Boolean | `false` | 隐藏状态栏 |
| `userAgent` | String? | `null` | 自定义 User-Agent |
| `injectedJavaScript` | String? | `null` | 注入的 JS |
| `jsBridgeName` | String | `"XWebViewBridge"` | JS 桥接对象名 |
| `debugEnabled` | Boolean | `false` | 开启远程调试 |
| `downloadDestination` | FileDownloadDestination | `Sandbox` | 下载存储目标 |
| `downloadNotificationTitle` | String? | `null` | 通知栏下载进度 |
| `onMessage` | (String) -> Unit? | `null` | H5 消息回调 |

## JSBridge 通信

```javascript
// H5 → Native
window.XWebViewBridge.postMessage(JSON.stringify({ type: 'login', token: '...' }))

// 监听下载进度
window.addEventListener('__xwvDownloadProgress', (e) => { ... })
window.addEventListener('__xwvDownloadDone', (e) => { ... })
```

## 文件选择与拍照

- `<input type="file">` + `accept="image/*"` + `capture` → 系统相机
- `<input type="file">` + `.docx/.xlsx` → 文件选择器
- `getUserMedia()` WebRTC → 自动请求 CAMERA 权限