进度条 ProgressBar
一、功能描述
RemoteProgressBar 是用于展示任务进度的水平进度条组件,对应 ViewType.PROGRESS_BAR。它支持设置当前进度、最大值与进度条颜色,适合展示上传 / 下载 / 加载等线性进度。
通过 RemoteViewHelper.createProgressBar() 创建:
val progressBar = helper.createProgressBar()
二、通用属性
以下属性通过对应的 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 | 背景形状:填充色 / 描边 / 圆角 |
进度条属性
| 方法 | 参数 | 说明 |
|---|---|---|
setProgress | Int | 当前进度值,需不超过 setMax 设置的最大值 |
setMax | Int | 最大进度值,默认 100 |
setProgressColor | Int | 进度填充颜色(ARGB Int) |
三、Tips
- 颜色只能传 ARGB Int。
setProgressColor/setBackground接收 Int 颜色值(如0xFF1A8BFF.toInt()或Color.RED)。不要传"#RRGGBB"、"0xAARRGGBB"或R.color.xxx。 - 修改已挂载组件的属性后要
syncToRemote()。setXxx只更新本地缓存,调用syncToRemote()才会批量同步到 Pilot。挂载前配置好属性则无需额外调用。 - 进度百分比 =
progress / max。若使用非 100 的自定义最大值,请通过setMax设置,并确保setProgress传入的值不超过该最大值。 - 进度条粗细由
setHeight控制。水平进度条的高度即为进度条的粗细,宽度建议设为MATCH_PARENT以充满容器。
四、示例代码
下方每组左侧为示例代码,右侧为对应的 Pilot 端渲染预览效果。
01 进度与样式(进度值 / 粗细 / 颜色)
// 不同进度值:33% / 66% / 100%
val p33 = helper.createProgressBar().apply {
setWidth(RemoteView.MATCH_PARENT); setHeight(12)
setMax(100); setProgress(33); setProgressColor(0xFF1A8BFF.toInt())
}
val p66 = helper.createProgressBar().apply {
setWidth(RemoteView.MATCH_PARENT); setHeight(12)
setMax(100); setProgress(66); setProgressColor(0xFF1A8BFF.toInt())
}
val p100 = helper.createProgressBar().apply {
setWidth(RemoteView.MATCH_PARENT); setHeight(12)
setMax(100); setProgress(100); setProgressColor(0xFF1A8BFF.toInt())
}
// 不同粗细(通过 setHeight):4dp / 8dp / 12dp
val thin = helper.createProgressBar().apply {
setWidth(RemoteView.MATCH_PARENT); setHeight(4)
setProgress(33); setProgressColor(0xFF1A8BFF.toInt())
}
val medium = helper.createProgressBar().apply {
setWidth(RemoteView.MATCH_PARENT); setHeight(8)
setProgress(66); setProgressColor(0xFF1A8BFF.toInt())
}
val thick = helper.createProgressBar().apply {
setWidth(RemoteView.MATCH_PARENT); setHeight(12)
setProgress(100); setProgressColor(0xFF1A8BFF.toInt())
}
// 不同颜色:蓝 / 橙 / 红
val blue = helper.createProgressBar().apply {
setWidth(RemoteView.MATCH_PARENT); setHeight(12)
setProgress(33); setProgressColor(0xFF1A8BFF.toInt())
}
val orange = helper.createProgressBar().apply {
setWidth(RemoteView.MATCH_PARENT); setHeight(12)
setProgress(66); setProgressColor(0xFFFF8100.toInt())
}
val red = helper.createProgressBar().apply {
setWidth(RemoteView.MATCH_PARENT); setHeight(12)
setProgress(88); setProgressColor(0xFFE41F29.toInt())
}
说明: 完整可运行示例见官方 Sample
open-pilot-plugin-sample的 drawing/ProgressBarDrawer.kt。