如何在Android Wear Proto Tile中设置Bitmap图片

Proto Tile框架不支持直接传入Bitmap对象，必须先将Bitmap转换为框架可序列化的ImageResource，再通过Image组件引用。以下是具体实现步骤：

1. 转换Bitmap为ImageResource #

使用AndroidImageResourceHelper工具类（来自protolayout-material库），将Bitmap转换为符合Proto格式的ImageResource：

import androidx.wear.protolayout.material.images.AndroidImageResourceHelper
import androidx.wear.protolayout.expression.proto.ImageResourceProto

// 假设你已获取到目标Bitmap对象
val targetBitmap: Bitmap = ...

// 转换为ImageResource
val imageResource = AndroidImageResourceHelper.createImageResourceFromBitmap(
    context = this, // 传入TileService的上下文
    bitmap = targetBitmap,
    // 可选：设置缓存策略，默认是磁盘+内存缓存
    cacheStrategy = ImageResourceBuilders.MemoryCacheStrategyBuilders.diskAndMemory()
)

2. 构建包含Bitmap的Image组件 #

使用Material库的Image组件（或原生ImageBuilders），将上面生成的ImageResource传入：

import androidx.wear.protolayout.material.images.Image
import androidx.wear.protolayout.material.layouts.PrimaryLayout
import androidx.wear.tiles.TileBuilders

// 构建Image组件
val customImage = Image.Builder(context)
    .setImageResource(imageResource)
    .setContentDescription("自定义Bitmap图片") // 无障碍描述必填
    .build()

// 将Image组件嵌入布局（示例用PrimaryLayout）
val tileContent = PrimaryLayout.Builder(context)
    .setContent(customImage)
    .build()

// 生成并返回Tile
return TileBuilders.Tile.Builder()
    .setResourcesVersion("1") // 资源版本号，更新时需变更
    .setTileContent(tileContent.toContent())
    .build()

关键说明 #

• Proto Tile基于ProtoBuf序列化传输，Bitmap无法直接序列化，必须通过AndroidImageResourceHelper转换为字节流或缓存资源，生成框架可识别的ImageResource。
• 你的依赖库已经包含protolayout-material，无需额外添加依赖即可使用AndroidImageResourceHelper。
• 如果是使用res目录下的静态图片，可直接用ImageResourceBuilders.resourceImageResource(R.drawable.your_image)，无需转换Bitmap。

内容的提问来源于stack exchange，提问作者Ajay Singh