Python抖音直播头像打印机源码下载/直播弹幕触发3D打印/礼物互动/抖音快手直播互动工具

Python直播头像打印机是一套面向抖音、TikTok等直播互动场景的3D打印辅助工具，通过读取直播间评论、点赞、关注、进场及礼物等公开互动事件，自动触发头像打印任务。观众参与直播互动后，可以将对应头像生成打印任务，并通过3D打印机呈现出来，适合搭建直播间头像打印、礼物互动及创意直播展示场景。

项目采用Python多进程与Node.js数据桥架构，提供独立直播间窗口、头像打印程序和实时数据连接功能。支持评论及礼物触发、打印规则自定义、头像缓存、语音播报及OBS独立场景窗口，同时提供中英文界面。源码免费开源，支持下载、安装、修改和二次开发。

直播头像打印机基本信息

抖音直播弹幕与礼物触发3D打印

程序通过本地直播间窗口读取公开直播互动数据，并利用数据桥将事件传递给头像打印页面。观众发送评论、点赞、关注或礼物后，可以根据预设规则生成对应的打印任务。

默认支持以下互动映射：

打印规则支持在直播连接面板中进行调整，包括评论、进场、点赞、关注、礼物是否打印，以及礼物语音播报、进场欢迎语音和无互动补位等选项。修改后立即生效，并在本地保存设置。

直播数据桥与实时连接

项目提供Node.js数据桥，通过本地浏览器直播页面获取公开互动事件，并通过WebSocket与头像打印程序通信。数据桥支持自动跟随直播间切换，可以在打印程序中修改房间号或直播链接，不必每次重新启动数据桥。

程序提供多种本地浏览器数据连接方式，包括独立直播间窗口、BrowserOS neo及开启调试端口的Chromium。数据桥按照约0.3秒的间隔采集直播页面数据，评论、礼物和点赞事件可以实时进入打印队列。

礼物任务采用优先排队机制，不会中断当前正在执行的打印任务；评论任务优先于点赞任务。点赞较多时还会进行频率控制，避免打印任务过于密集。

观众头像获取与本地缓存

程序提供多层头像获取机制，包括直播数据协议解析、页面观众列表及贡献榜采集，以及通过观众资料卡补充获取头像信息。

获取到的头像可以保存至本地 avatar-cache.json，不同直播间及程序重启后能够复用已有缓存。对于暂时无法获取头像的用户，系统支持生成带有彩色背景和首字的替代头像，避免打印页面出现空白占位效果。

需要特别说明：抖音直播页面并不公开每一个点赞行为对应的具体点赞用户，因此程序的点赞头像采用观众花名册轮换归属，并非平台确认的实际点赞者身份。直播互动展示时应避免将这种轮换结果误认为真实点赞用户记录。

直播自动补位与语音播报

当直播间连续30秒没有评论、点赞、礼物、关注或进场等互动事件时，程序可以自动加入测试头像，避免打印展示画面长时间没有变化。真实互动事件到达后，自动补位会让位于真实直播数据。

系统还支持礼物语音播报、观众进场欢迎语音及自定义打印规则。中英文版本分别使用独立页面和语音文件，方便针对不同语言的直播场景进行调整。

OBS独立场景窗口与双窗口直播

程序提供独立直播场景窗口，可以将3D打印画面单独弹出，形成纯展示页面，不显示后台管理面板，方便通过OBS进行窗口采集或在第二块显示器上展示。

场景窗口打开时由独立窗口接管打印任务，主窗口仅显示统计信息，避免重复打印；关闭场景窗口后，主窗口自动恢复打印控制。

另外支持1080×1920竖屏直播窗口，适合抖音及其他竖屏直播画面布局。

一键启动与运行方式

项目提供批处理启动脚本，方便在Windows环境下运行。

start.bat

用于启动头像打印服务。也可以使用以下脚本启动完整双窗口环境：

start-all.bat

完整启动后，会自动运行打印服务、打开直播间窗口，并以独立应用窗口显示头像打印程序。用户可以在直播间窗口中扫码登录抖音，登录状态由对应浏览器配置保存。

需要单独启动数据桥时，可以使用：

start-bridge.bat

也可以分别运行打印服务和数据桥。首次使用新版桌面程序前，建议关闭旧版ServerGuard、BridgeGuard及遗留的数据桥进程，避免端口占用。

运行环境与适用场景

项目需要安装Python、Node.js、pywebview及WebView2 Runtime。程序通过本地WebSocket进行数据通信，默认使用本机地址 ws://127.0.0.1:8765。

该开源项目适合用于抖音直播头像打印、TikTok互动直播、3D打印直播展示、直播礼物互动及OBS创意直播场景。通过直播数据桥、头像获取、自动排队和独立展示窗口，可以将观众互动转化为直观的3D打印直播效果。

程序读取直播间公开互动信息，不提供自动发送弹幕或赠送礼物功能。使用时应遵守相应直播平台的规则，并注意观众头像等个人信息的使用范围。