网页 WebView
一、功能描述
RemoteWebView 是用于加载并展示网页的组件,对应 ViewType.WEB_VIEW。它通过设置一个完整的 URL,在 Pilot 端渲染对应网页,适合嵌入在线帮助文档、实时数据面板、H5 页面等。
通过 RemoteViewHelper.createWebView() 创建:
val webView = helper.createWebView()
二、通用属性
以下属性通过对应的 setXxx() 方法设置。除标注外,属性修改后若组件已挂载,需调用 syncToRemote() 使其在 Pilot 端生效。
尺寸与布局
| 方法 | 参数 | 说明 |
|---|---|---|
setWidth | Int | 宽度(dp);特殊值 RemoteView.MATCH_PARENT(-1) / WRAP_CONTENT(-2) |
setHeight | Int | 高度(dp);同上支持特殊值 |
setMinSize | minWidth: Int, minHeight: Int | 最小尺寸(dp) |
setPadding | left, top, right, bottom: Int | 内边距(dp) |
setVisibility | VisibilityType | 可见性:VISIBLE / INVISIBLE / GONE |
setAlpha | Float | 透明度,0.0 ~ 1.0 |
setEnabled | Boolean | 是否可用 |
背景与形状
| 方法 | 参数 | 说明 |
|---|---|---|
setBackground | Int | 背景纯色(ARGB Int) |
setBackgroundShape | ShapeDescriptor | 背景形状:填充色 / 描边 / 圆角 |
网页属性
| 方法 | 参数 | 说明 |
|---|---|---|
setUrl | String | 加载的网页 URL(须为完整的 http / https 地址) |
三、Tips
- URL 必须是完整地址。
setUrl需传入带协议头的完整地址(如https://www.dji.com),不要只传www.dji.com或相对路径,否则无法加载。 - 建议给 WebView 明确的宽高。用
setWidth/setHeight指定确定尺寸(如MATCH_PARENT宽 + 固定高150),避免尺寸塌陷导致网页不可见或渲染异常。 - 背景颜色只能传 ARGB Int。
setBackground接收 Int 颜色值,不要传"#RRGGBB"、"0xAARRGGBB"或R.color.xxx。 - 修改已挂载组件的属性后要
syncToRemote()。setXxx只更新本地缓存,调用syncToRemote()才会批量同步到 Pilot;挂载前配置好属性则无需额外调用。
四、示例代码
下方每组左侧为示例代码,右侧为对应的 Pilot 端渲染预览效果。
01 组件类型(加载网页)
// 加载网页:完整 URL + 明确宽高
val webView = helper.createWebView().apply {
setWidth(RemoteView.MATCH_PARENT)
setHeight(150)
setUrl("https://developer.dji.com/doc/mobile-sdk-tutorial/cn/")
}
说明: 完整可运行示例见官方 Sample
open-pilot-plugin-sample的 drawing/WebViewDrawer.kt。