visualInfo 资源类型
命名空间:microsoft.graph
用于表示活动对象中的 visualElements 属性的复杂类型。
每个用户活动将在时间线中显示为自适应卡片。 建议应用开发人员提供自定义卡片,以捕获应用中发生的活动的本质。 这可以通过在 content 属性中提供自定义 JSON 卡实现。
除了具有自适应卡片的视觉元数据外,应用还可以指定内容元数据 - 用于对用户活动生成推理的数据,以便为将来的重新参与提供新活动。 通过使用活动的 contentInfo 属性提供 JSON 对象,该对象利用 schema.org 属性来描述内容,可以实现此目的。
如果未提供自定义卡片,将使用 displayText 和 description 属性生成简单的卡片。 建议使用自定义卡片来展示应用中的最佳内容。
属性
名称 | 类型 | 说明 |
---|---|---|
归 因 | imageInfo | 可选。 用于表示图标的 JSON 对象,该图标表示用于生成活动的应用程序 |
backgroundColor | String | 可选。 用于在 UI 中呈现活动的背景色 - 活动的应用程序源的品牌颜色。 必须是有效的十六进制颜色 |
content | 非类型化 JSON 对象 | 可选。 自定义数据片段 - 用于提供自定义内容以在 Windows Shell UI 中呈现活动的 JSON 对象 |
说明 | String | 可选。 用户唯一活动的较长文本说明 (示例:文档名称、第一句和/或元数据) |
displayText | String | 必填。 用户唯一活动的简短文本说明 (例如,在活动引用文档创建的情况下的文档名称) |
JSON 表示形式
以下 JSON 表示形式显示了资源类型。
{
"@odata.type": "microsoft.graph.visualInfo",
"attribution": {
"@odata.type": "microsoft.graph.imageInfo",
"iconUrl": "String (URL)",
"alternateText": "String",
"addImageQuery": "boolean"
},
"description": "String",
"backgroundColor": "String",
"displayText": "String",
"content": {
"@odata.type": "microsoft.graph.Json"
}
}