网页 WebView

2026-09-20评分加载中…

一、功能描述

RemoteWebView 是用于加载并展示网页的组件,对应 ViewType.WEB_VIEW。它通过设置一个完整的 URL,在 Pilot 端渲染对应网页,适合嵌入在线帮助文档、实时数据面板、H5 页面等。

通过 RemoteViewHelper.createWebView() 创建:

val webView = helper.createWebView()

二、通用属性

以下属性通过对应的 setXxx() 方法设置。除标注外,属性修改后若组件已挂载,需调用 syncToRemote() 使其在 Pilot 端生效。

尺寸与布局

方法参数说明
setWidthInt宽度(dp);特殊值 RemoteView.MATCH_PARENT(-1) / WRAP_CONTENT(-2)
setHeightInt高度(dp);同上支持特殊值
setMinSizeminWidth: Int, minHeight: Int最小尺寸(dp)
setPaddingleft, top, right, bottom: Int内边距(dp)
setVisibilityVisibilityType可见性:VISIBLE / INVISIBLE / GONE
setAlphaFloat透明度,0.0 ~ 1.0
setEnabledBoolean是否可用

背景与形状

方法参数说明
setBackgroundInt背景纯色(ARGB Int)
setBackgroundShapeShapeDescriptor背景形状:填充色 / 描边 / 圆角

网页属性

方法参数说明
setUrlString加载的网页 URL(须为完整的 http / https 地址)

三、Tips

  1. URL 必须是完整地址。setUrl 需传入带协议头的完整地址(如 https://www.dji.com),不要只传 www.dji.com 或相对路径,否则无法加载。
  2. 建议给 WebView 明确的宽高。用 setWidth / setHeight 指定确定尺寸(如 MATCH_PARENT 宽 + 固定高 150),避免尺寸塌陷导致网页不可见或渲染异常。
  3. 背景颜色只能传 ARGB Int。setBackground 接收 Int 颜色值,不要传 "#RRGGBB"、"0xAARRGGBB" 或 R.color.xxx。
  4. 修改已挂载组件的属性后要 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.ktopen in new window。

最近修改: