Mastodon
mastodon 平台使用 Mastodon
设置
在 Mastodon 网络界面中转到 偏好设置，然后转到 开发 并创建一个新应用程序。
检查以下作用域 read:accounts, write:statuses 和 write:media。
选择 提交 创建应用程序并生成集成所需的密钥、密语和令牌。
配置
要将 Mastodon 服务 添加到您的 Home Assistant 实例中，请使用此 My 按钮：
如果上述 My 按钮不起作用，您也可以手动执行以下步骤：
-
浏览到您的 Home Assistant 实例。
-
转到
设置 > 设备与服务。 -
在右下角，选择
Add Integration 按钮。 -
从列表中选择 Mastodon。
-
按照屏幕上的说明完成设置。
传感器
集成将为 Mastodon 帐户创建传感器，显示总关注者、正在关注和帖子。传感器每小时更新一次。
操作
Mastodon 集成具有以下操作：
mastodon.post
之前的 notify.mastodon 服务已被弃用，以支持新的 mastodon.post 操作。如果您正在从先前的版本升级，您需要更新您的自动化以使用下面显示的新操作格式。
操作 mastodon.post
发布状态到您的 Mastodon 帐户
| 数据属性 | 可选 | 描述 |
|---|---|---|
config_entry_id |
否 | 要发布的 Mastodon 配置条目的 ID。 |
status |
否 | 要发布的状态文本。 |
visibility |
是 | 如果未使用，将默认为账户设置。public: 发布将是公开的，unlisted: 发布将是公开的，但不出现在公共时间线上，private: 发布将仅对关注者可见，以及 direct: 发布仅对提及的用户可见。 |
content_warning |
是 | 文本将作为警告显示在状态文本之前。如果未使用，将不显示警告。 |
media |
是 | 为帖子附加图像或视频。 |
media_description |
是 | 如果附加了图像或视频，将为视觉障碍者添加此媒体的描述。 |
media_warning |
是 | 如果附加了图像或视频，True 将标记该媒体为敏感。False 是默认值。 |
示例
示例状态发布操作
示例发布操作，将使用您账户的默认可见性发布状态：
- action: mastodon.post
config_entry_id: YOUR_MASTODON_CONFIG_ENTITY_ID
status: "来自 Home Assistant 的一条 toot"
示例私密发布操作
这将向 Mastodon 发布状态，但可见性标记为 private，因此只有关注者会看到它。
- action: mastodon.post
config_entry_id: YOUR_MASTODON_CONFIG_ENTITY_ID
status: "来自 Home Assistant 的私密 toot"
visibility: private
示例媒体发布操作
这将向 Mastodon 发布一条包含图像的状态。
- action: mastodon.post
config_entry_id: YOUR_MASTODON_CONFIG_ENTITY_ID
status: "来自 Home Assistant 的一条媒体 toot"
media: /config/www/funny_meme.png
示例带媒体和内容警告的帖子，公共时间线中将不可见
这将向 Mastodon 发布一条状态，包含图像、描述、内容警告和 unlisted 的可见性，因此它不会显示在公共时间线上。
- action: mastodon.post
config_entry_id: YOUR_MASTODON_CONFIG_ENTITY_ID
status: "来自 Home Assistant 的一条媒体 toot"
visibility: unlisted
media: /config/www/funny_meme.png
media_description: "一个有趣的 meme"
content_warning: "这可能不够搞笑"
有关如何在自动化中使用通知的更多信息，请参见 自动化入门页面。
已知限制
该集成仅允许读取经过身份验证的帐户的状态以及向该帐户发布状态。它不提供获取流、收藏、书签或提升该帐户的帖子功能。
删除集成
该集成遵循标准集成删除流程，一旦集成被删除，您可以通过在 Mastodon 网络界面中转到 偏好设置，然后转到 开发 并删除您为 Home Assistant 创建的应用程序注册（假设它仅被此集成使用）来删除应用程序注册。
从Home Assistant中移除集成实例
- 前往 设置 > 设备与服务 并选择集成卡片。
- 从设备列表中，选择要删除的集成实例。
- 在条目旁边，选择三个点
菜单。然后，选择 删除。