Microsoft Teams任务模块Adaptive Card深色主题白背景异常如何修复

问题原因 #

Microsoft Teams任务模块加载自适应卡片时，默认不会自动注入当前主题的背景色配置，未显式开启主题适配的自适应卡片会强制使用白色背景，在深色主题下就会出现显示异常。

修复步骤 #

• 第一步：在自适应卡片JSON的根节点添加Teams专属扩展配置，开启主题色注入能力
  你需要在所有自适应卡片（包括Action.ShowCard嵌套的子卡片）的根层级添加以下配置：

  "msteams": {
    "allowThemeColorInjection": true
  }
  

  修改后的根卡片JSON示例：

  {
    "type": "AdaptiveCard",
    "version": "1.3",
    "msteams": {
      "allowThemeColorInjection": true
    },
    "body": [
      // 原有body内容保持不变
    ],
    "actions": [
      // 原有actions内容保持不变，注意每个ShowCard的子卡片也要添加上述msteams配置
    ]
  }
  

• 第二步：C#初始化代码适配
  如果你是通过C# SDK动态生成自适应卡片，可以通过AdditionalProperties属性注入上述配置，无需手动修改JSON：

  AdaptiveCard adaptiveCard = new AdaptiveCard(new AdaptiveSchemaVersion(1, 3));
  // 注入Teams主题适配配置
  adaptiveCard.AdditionalProperties["msteams"] = new { allowThemeColorInjection = true };
  // 嵌套的子卡片也需要添加同样的配置，遍历所有ShowCard的子卡片逐一添加即可
  

• 可选兜底方案：如果上述配置仍未生效，可以显式指定背景色为Teams主题变量
  在卡片根节点添加background属性，使用自适应卡片模板语法调用Teams宿主的主题颜色：

  "background": "${theme.backgroundColor}"
  

  该配置会自动匹配当前Teams主题的背景色，同时兼容浅色、深色、高对比度三种主题模式。

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