MoviePilot媒体服务器通知插件配置指南
MoviePilot媒体服务器通知插件配置指南
【免费下载链接】MoviePilot NAS媒体库自动化管理工具 
项目地址: https://gitcode.com/gh_mirrors/mo/MoviePilot
问题背景
在使用MoviePilot v2.1.9-1版本时，部分用户反馈媒体服务器通知插件无法正常工作，具体表现为：虽然测试Webhook能够成功发送，MoviePilot日志也能收到消息，但在Emby媒体库实际播放和停止播放时却无法收到插件通知。
环境配置
- 运行环境：Docker容器
- 相关组件：Emby媒体服务器
- 通知方式：支持即时通讯工具、微信等多种通知渠道
问题分析与解决方案
1. Webhook通知类型设置
关键发现：Emby的通知类型需要设置为form-data格式才能正常工作。这是许多用户遇到问题的首要原因。
配置步骤：
- 进入Emby管理界面
- 找到Webhook设置选项
- 将通知类型修改为
form-data - 保存设置并重启相关服务
2. 调试日志查看
为了确认Webhook是否正常工作，需要开启MoviePilot的调试日志：
- 进入MoviePilot设置
- 选择"高级设置"
- 进入"日志"选项
- 开启"调试模式"
- 保存设置
开启后，可以在日志中查看到Webhook的详细通知信息，帮助诊断问题。
3. 通知范围设置
确保通知能够发送给所有用户：
- 进入MoviePilot的"通知设置"
- 在"通知发送范围"中
- 将所有选项设置为"所有用户"
- 保存设置
4. Emby事件订阅
在Emby中必须正确配置需要订阅的事件：
- 确保勾选了"播放开始"和"播放停止"事件
- 检查Webhook的URL是否正确指向MoviePilot实例
- 验证Webhook的token参数是否正确
5. 通知渠道验证
对于使用即时通讯工具通知的用户，需要额外检查：
- 确认机器人能接收其他类型的通知
- 测试网络连通性确保能访问API
- 检查用户ID设置是否正确
特殊案例处理
部分用户使用特殊版本的Emby(如修改版)可能会遇到Webhook请求体格式问题。这种情况下：
- 检查Emby版本是否兼容
- 考虑升级到官方推荐版本
- 或者手动调整Webhook的请求体格式
最佳实践建议
- 版本选择：推荐使用稳定版本的Emby，如4.9.0.34版本
- 逐步测试：先确保Webhook能收到基本通知，再扩展功能
- 权限检查：确保所有相关服务有足够的权限互相通信
- 日志分析：遇到问题时首先查看详细日志
总结
MoviePilot的媒体服务器通知功能需要Emby和MoviePilot两端的正确配置才能正常工作。通过本文提供的解决方案，大多数通知问题都可以得到有效解决。对于特殊环境或定制版本，可能需要额外的调试和配置调整。
【免费下载链接】MoviePilot NAS媒体库自动化管理工具 项目地址: https://gitcode.com/gh_mirrors/mo/MoviePilot
