跳到主要内容

OBS Studio:收款二维码与付款提醒

Heth 小组件是 OBS Studio 中的浏览器源,用于显示收款二维码及已完成的 Heth 收款提醒。它不会安装原生 OBS 插件,也不会控制场景、录制或推流。收到转账并不自动意味着该款项属于作者或平台捐赠。

更新后的小部件英文预览。示例事件;预览 QR 不发起付款。

新版小组件的英文预览。图中事件为演示数据;预览二维码不会发起付款。

连接小部件​

  1. 打开 Heth 并登录将接收捐款的帐户。
  2. 打开设置 → OBS Studio。收款方为您当前登录的 Heth 账户。
  3. 选择可用的币种与网络组合。可选填建议金额、说明文字、主题及语言;金额留空时由付款人选择。
  4. Save the appearance.选择 批准并创建 OBS 连接 为小部件创建单独的、受限的访问权限。
  5. 复制连接 URL。在 OBS 中添加浏览器源并粘贴该 URL。初始尺寸可设为 900 × 500 像素,再按场景调整大小或裁剪。
  6. 用手机扫描二维码,核对收款方、币种与网络。确认任何付款前,请查看付款界面。二维码本身不会转移资金。

背景为透明。请勿遮挡二维码,并保持足够尺寸以便扫描。在实际场景中检查效果,包括观众实际接收到的分辨率。小组件支持俄语和英语,其语言独立于 Heth 的界面语言。

访问权限与隐私​

连接使用一个仅限 OBS 的独立 API 密钥。Heth 会创建密钥并将其放入连接 URL,无需从业务设置中手工复制密钥。已有 webhook 设置与此独立:webhook 将事件发送至您的服务器,而 OBS 浏览器源直接读取受限的小组件数据源。使用标准小组件无需运行 webhook 接收服务。

OBS 密钥属于您的账户,可读取该账户的小组件数据源。MCP 权限单独授予;撤销 OBS 连接与撤销 AI 连接是两项独立操作。

连接 URL 在 # 后的片段中包含私有 OBS 访问令牌。请将整个 URL 作为机密处理,不要放入直播说明、截图、公开导出的场景或 AI 对话。观众看到的二维码仅含付款信息,不含该令牌。

OBS 访问权限仅可读取收款标识、外观设置和受限的收款事件流;不能读取余额或完整交易记录、发送资金或编辑设置。如果连接 URL 泄露或已停止使用,请在设置 → OBS Studio中撤销旧连接;需要时在 Heth 中创建新连接。

提醒的工作方式​

提醒仅对应状态为 charged 的入账转账,不包括待处理、失败或转出的操作。金额采用收款方金额及其存储精度,不会舍入为整枚代币;若无法取得精度,小组件不会编造金额。

新的联系从新的事件开始。正在运行的浏览器源可以在短暂中断后从其保存的光标处恢复;其重播窗口仅限于 24 小时。重新加载或重新创建源并不是导出帐户历史记录的方法。验证交易历史记录中的收据和最终操作详细信息,独立于流中警报。

使用 AI 助手更改小部件​

使用具有适当权限的远程 MCP 服务 的连接助手可以读取小部件设置、查看受限事件源并提出连接。可以在AI客户端确认后更改普通外观设置。已连接的小部件会自动刷新保存的外观,通常在 30 秒内。

创建或撤销访问权限以及更改接收帐户需要在 Heth 中进行确认。助手提供了 Heth 设置屏幕的链接;它不接收私有 OBS 连接 URL。示例请求:“为我的 OBS 小部件使用英文标题和最小主题”或“显示我的小部件最近传入的事件”。 MCP本身并没有给予OBS Studio的辅助控制。

自己的布局和AI辅助定制​

标准 Heth 设置不需要源代码访问。对于任意布局,请分叉公共 Heth OBS widget,在 MIT 下获得许可。从其 AI 指南 、文件映射和托管说明开始。该存储库包括构建和托管说明。

有权访问您的副本的编码助理可以更改布局、CSS、字体、颜色和通知演示,然后检查综合预览和构建。它不需要您的实时 OBS 连接 URL 或支付凭证。必须托管自定义构建:公共存储库本身不提供收款警报。

Heth MCP 可以读取事件并更改支持的 Heth 外观设置。它不会编辑存储库、编译自定义版本或授予助理访问您的托管帐户的权限。对于任意HTML/CSS布局,自定义开源项目。您可以继续使用标准 Heth 托管的小部件,而无需构建任何内容。

故障排除​

Heth 显示 404 而不是小部件: 更新 Heth,检查浏览器源 URL 并重新打开源。如果错误仍然存​​在,请联系支持人员。不要创建新密钥来修复页面加载错误。

  • 无 OBS 设置条目: 更新 Heth 并在支持人员的帮助下检查您的帐户访问权限。请勿将普通帐户 API 密钥粘贴到小部件 URL 中。
  • 出现二维码但没有提醒: 确认转账已完成且收款方为此账户。浏览器源必须保持启用并联网。
  • 访问已禁用: 在 Heth 中重新建立连接。重试已撤销的 URL 不会恢复权限。
  • 币种或网络错误: 在 Heth 中修正设置,等待小组件刷新,并在接受付款前重新扫描二维码。
  • **旧URL使用api_key=:**通过设置→OBS Studio重新连接。将旧的 URL 保密并撤销过时的帐户密钥。