Emby Server API 技能

配置

配置参数位于 emby.py 文件顶部:

python
BASE_URL = https://emby.example.com/emby # 修改为你的Emby服务器地址
API_KEY = 652436b1ffa84d9a85f579eeb34b87aa # 修改为你的API Key

使用方式

导入 emby 模块并调用相应函数:

python
from emby import getitems, getuserbyid, downloaditemimage

返回值类型

• - JSON返回: 大多数API调用返回 Dict (字典)
• Stream返回: 图片、视频、音频下载等返回 Response 对象或 bytes

Stream 类型函数 (返回 Response)

函数	用途
getitemimage()	获取媒体项图片
downloaditemimage()

下载媒体项图片到文件或返回bytes | | getvideostream_url() | 获取视频流地址 | | download_video() | 下载视频到文件或返回bytes | | getaudiostream_url() | 获取音频流地址 | | download_audio() | 下载音频到文件或返回bytes | | postdevicescamera_uploads() | 上传摄像头内容 | | restore_backup() | 恢复备份 |

常用函数示例

查询媒体库

python

查询所有电影

movies = getitems(includeitem_types=Movie, recursive=True, limit=20)

搜索媒体

results = getitems(searchterm=avatar, recursive=True)

按类型查询

series = getitems(includeitem_types=Series, recursive=True)

用户管理

python

获取所有用户

users = query_users()

获取指定用户

user = getuserby_id(user-id-here)

标记影片为已播放

markitemplayed(userid=user-id, itemid=item-id)

图片操作

python

获取图片Response对象

resp = getitemimage(itemid=xxx, imagetype=Primary, index=0)

下载图片到文件

downloaditemimage(itemid=xxx, imagetype=Primary, output_path=poster.jpg)

直接获取图片bytes

bytesdata = downloaditemimage(itemid=xxx, image_type=Primary)

视频/音频下载

python

下载视频

downloadvideo(itemid=xxx, output_path=movie.mp4)

下载音频

downloadaudio(itemid=xxx, output_path=song.mp3)

Live TV

python

获取频道

channels = getlivetv_channels()

获取节目指南

programs = getlivetvprograms(channelid=xxx, starttime=2024-01-01, endtime=2024-01-07)

获取录制

recordings = getlivetv_recordings()

完整API列表

详见 emby.py 文件，包含以下分类:

• - Artists - 艺术家相关
• Albums - 专辑相关
• Codecs - 编解码器
• Channels/Collections - 频道/收藏
• Devices - 设备管理
• Genres - 类型
• Items - 媒体项
• Users - 用户管理
• UserData - 用户数据
• Sessions - 会话
• Playlists - 播放列表
• Plugins - 插件
• Library - 媒体库
• LiveTV - 直播电视
• LiveStreams - 直播流
• Localization - 本地化
• Movies - 电影
• AudioBooks - 有声书
• Auth - 认证
• Backup - 备份
• Branding - 品牌
• Connect - Emby Connect
• DisplayPreferences - 显示偏好
• DLNA - DLNA
• Encoding - 编码设置
• Environment - 环境
• Images - 图片
• Packages - 包
• Persons - 人物
• Studios - 工作室
• Tags - 标签
• Trailers - 预告片
• Years - 年份
• Features - 特性
• UI - 用户界面
• Videos - 视频操作
• Web - Web配置
• OpenAPI - OpenAPI文档
• Playback - 播放
• Hubs - 中心
• Search - 搜索