Wear OS中如何为ShortTextComplicationData添加图标？

要给ShortTextComplicationData添加图标，你需要正确创建MonochromaticImage对象，再通过setMonochromaticImage()方法传入即可。以下是具体实现步骤：

1. 创建MonochromaticImage实例 #

MonochromaticImage必须通过其Builder类创建，需要传入图片资源（或Drawable对象）和对应的内容描述（用于无障碍支持）。

方式一：从资源ID创建（常用场景） #

如果图标是res/drawable目录下的静态资源，直接用资源ID构建：

val monochromaticImage = MonochromaticImage.Builder(
    ContextCompat.getDrawable(context, R.drawable.your_icon)!!
)
    .setContentDescription(PlainComplicationText.Builder("图标的无障碍描述").build())
    .build()

方式二：从Drawable对象创建（动态场景） #

如果是动态生成的Drawable，直接传入对象即可：

val customDrawable = // 你的动态Drawable实例
val monochromaticImage = MonochromaticImage.Builder(customDrawable)
    .setContentDescription(PlainComplicationText.Builder("图标的无障碍描述").build())
    .build()

2. 修改原代码添加图标 #

把创建好的MonochromaticImage传入ShortTextComplicationData.Builder的setMonochromaticImage()方法，完整代码如下：

private fun createComplicationData(
    context: Context,
    text: String,
    contentDescription: String
): ShortTextComplicationData {
    // 创建单色图标
    val monochromaticImage = MonochromaticImage.Builder(
        ContextCompat.getDrawable(context, R.drawable.your_icon)!!
    )
        .setContentDescription(PlainComplicationText.Builder("图标内容描述").build())
        .build()

    return ShortTextComplicationData.Builder(
        text = PlainComplicationText.Builder(text).build(),
        contentDescription = PlainComplicationText.Builder(contentDescription).build()
    )
        .setMonochromaticImage(monochromaticImage) // 绑定图标
        .build()
}

注意事项：

• 建议使用符合Wear OS设计规范的单色图标，系统会自动适配表盘主题颜色
• 必须设置内容描述，否则会影响无障碍体验
• 调用ContextCompat.getDrawable()时，实际项目中建议用安全调用或判空处理，避免空指针异常

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