2025完全指南：用PyChromecast无痛控制Chromecast播放BBC Sounds音频

原创 于 2025-06-24 09:07:21 发布 · 451 阅读 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。

2025完全指南：用PyChromecast无痛控制Chromecast播放BBC Sounds音频

【免费下载链接】pychromecast Library for Python 3 to communicate with the Google Chromecast. 【免费下载链接】pychromecast 项目地址: https://gitcode.com/gh_mirrors/py/pychromecast

引言：告别繁琐操作，实现Chromecast音频自由

你是否还在为手动操作Chromecast播放BBC Sounds音频而烦恼？面对复杂的网页界面和繁琐的投屏步骤，是否渴望一种更高效、更自动化的控制方式？本文将带你深入探索如何使用PyChromecast库，通过Python代码轻松实现对Chromecast设备的精准控制，一键播放你喜爱的BBC Sounds音频内容。无论你是Python初学者还是有经验的开发者，读完本文后，你将能够：

  • 快速搭建PyChromecast开发环境
  • 掌握Chromecast设备的发现与连接技巧
  • 轻松获取BBC Sounds的媒体ID（包括直播和非直播内容）
  • 自定义音频播放的元数据（标题、封面等）
  • 实现高级播放控制（音量调节、暂停/继续等）
  • 解决常见的连接和播放问题

环境准备：从零开始搭建开发环境

硬件与软件要求

在开始之前，请确保你具备以下条件：

  • 一台运行Python 3.7+的计算机
  • 一个可用的Google Chromecast设备（或内置Chromecast功能的智能电视）
  • 计算机与Chromecast设备处于同一局域网
  • 稳定的互联网连接（用于访问BBC Sounds内容）

安装PyChromecast库

首先，克隆项目仓库并安装必要的依赖：

# 克隆项目仓库
git clone https://gitcode.com/gh_mirrors/py/pychromecast.git
cd pychromecast

# 创建并激活虚拟环境（可选但推荐）
python -m venv venv
source venv/bin/activate  # Linux/Mac
# 或
venv\Scripts\activate  # Windows

# 安装依赖
pip install -r requirements.txt

依赖包详解

PyChromecast的核心依赖包及其作用如下：

依赖包版本作用
casttube0.2.1与YouTube Cast API交互的库
protobuf5.29.3处理Google Cast协议的序列化格式
zeroconf0.147.0实现零配置网络发现，用于查找Chromecast设备

快速入门：5分钟实现BBC Sounds音频播放

发现Chromecast设备

在控制Chromecast之前，我们需要先发现网络中的设备。创建一个简单的Python脚本discover_chromecast.py：

import pychromecast

# 发现所有Chromecast设备
chromecasts, browser = pychromecast.get_chromecasts()

if not chromecasts:
    print("未发现任何Chromecast设备")
else:
    print(f"发现{len(chromecasts)}个Chromecast设备:")
    for i, cast in enumerate(chromecasts):
        print(f"{i+1}. 名称: {cast.name}, IP: {cast.host}, 型号: {cast.model_name}")

# 停止发现服务
browser.stop_discovery()

运行脚本后，你将看到网络中所有可用的Chromecast设备列表。记下你要使用的设备名称或IP地址，后续步骤会用到。

播放BBC Sounds直播音频

下面我们来实现一个最简单的BBC Sounds直播播放脚本。以BBC Radio 1为例：

import pychromecast
from pychromecast import quick_play

# 要连接的Chromecast设备名称
CAST_NAME = "你的Chromecast设备名称"

# BBC Radio 1的媒体ID (从URL中获取: https://www.bbc.co.uk/sounds/play/live:bbc_radio_one)
MEDIA_ID = "bbc_radio_one"

# 获取设备列表并连接
chromecasts, browser = pychromecast.get_listed_chromecasts(friendly_names=[CAST_NAME])
if not chromecasts:
    print(f"未找到名称为'{CAST_NAME}'的Chromecast设备")
    exit(1)

cast = chromecasts[0]
cast.wait()  # 等待连接建立

# 播放BBC Sounds音频
app_name = "bbcsounds"
app_data = {
    "media_id": MEDIA_ID,
    "is_live": True,  # 直播内容设为True
    "metadata": {
        "metadatatype": 0,
        "title": "BBC Radio 1",
        "images": [{"url": "https://sounds.files.bbci.co.uk/2.3.0/networks/bbc_radio_one/background_1280x720.png"}]
    }
}

quick_play.quick_play(cast, app_name, app_data)
print(f"成功播放BBC Radio 1，设备: {CAST_NAME}")

# 保持连接以查看状态（实际应用中可根据需要调整）
import time
time.sleep(30)

browser.stop_discovery()

将CAST_NAME替换为你的设备名称，运行脚本后，你的Chromecast设备应该会开始播放BBC Radio 1的直播内容。

深入理解：BBC Sounds控制器工作原理

工作流程解析

PyChromecast控制Chromecast播放BBC Sounds的工作流程如下：

mermaid

BBC Sounds控制器核心代码解析

PyChromecast的BbcSoundsController类是实现BBC Sounds播放的核心，其关键代码如下：

class BbcSoundsController(BaseMediaPlayer):
    """Controller to interact with BBC Sounds namespace."""

    def __init__(self) -> None:
        super().__init__(APP_BBCSOUNDS)
        self.logger = logging.getLogger(__name__)

    def quick_play(
        self,
        *,
        media_id: str,
        timeout: float,
        is_live: bool = False,
        metadata: dict[str, Any] | None = None,
        **kwargs: Any,
    ) -> Any:
        """Quick Play helper for BBC Sounds media"""
        stream_type = STREAM_TYPE_LIVE if is_live else STREAM_TYPE_BUFFERED
        metadata_default = {"metadataType": 0, "title": ""}
        if metadata is None:
            metadata = metadata_default
        super().quick_play(
            media_id=media_id,
            media_type=None,
            stream_type=stream_type,
            metadata=metadata,
            timeout=timeout,
            **kwargs,
        )

这个控制器实现了与BBC Sounds应用的通信协议，处理媒体ID解析、流类型设置和元数据传递等核心功能。

媒体ID获取：直播与非直播内容的区别

直播内容媒体ID

BBC Sounds的直播内容（如电台直播）媒体ID可以直接从URL中获取：

  1. 打开BBC Sounds网站并找到你想播放的直播内容
  2. 查看URL，直播内容URL格式通常为：https://www.bbc.co.uk/sounds/play/live:媒体ID
  3. live:后面的部分即为直播媒体ID

例如，BBC Radio 1的URL为https://www.bbc.co.uk/sounds/play/live:bbc_radio_one，其媒体ID为bbc_radio_one。

非直播内容媒体ID

非直播内容（如节目点播）的媒体ID获取较为复杂：

  1. 打开BBC Sounds网站并播放你想获取ID的非直播内容
  2. 在播放界面上右键单击，选择"检查"或"查看页面源代码"
  3. 在开发者工具中搜索"mediaId"或查看网络请求，找到类似"mediaId":"m0015vcg"的内容
  4. 引号中的值即为非直播媒体ID

直播与非直播参数对比

参数直播内容非直播内容
media_idURL中live:后面的部分播放页面源代码中的mediaId值
is_liveTrueFalse
时间显示仅显示当前时间显示当前时间/总时长
快进/后退通常不可用可用
示例URLhttps://www.bbc.co.uk/sounds/play/live:bbc_radio_twohttps://www.bbc.co.uk/sounds/play/m0015vch
示例media_idbbc_radio_twom0015vcg

高级功能：自定义播放体验

自定义元数据

你可以自定义显示在Chromecast设备上的音频信息，如标题、封面图片等：

# 自定义元数据示例
metadata = {
    "metadatatype": 0,
    "title": "我的自定义BBC Radio 1",  # 显示的标题
    "subtitle": "最佳流行音乐",  # 副标题
    "images": [
        {
            "url": "https://example.com/custom-image.jpg",  # 自定义封面图片URL
            "width": 480,
            "height": 480
        }
    ]
}

# 使用自定义元数据播放
app_data = {
    "media_id": "bbc_radio_one",
    "is_live": True,
    "metadata": metadata  # 传入自定义元数据
}
quick_play.quick_play(cast, "bbcsounds", app_data)

播放控制

PyChromecast提供了丰富的播放控制功能：

# 暂停播放
cast.media_controller.pause()

# 继续播放
cast.media_controller.play()

# 停止播放
cast.media_controller.stop()

# 调整音量（0.0到1.0之间）
cast.set_volume(0.7)  # 设置音量为70%

# 增加音量
cast.volume_up(delta=0.1)  # 增加10%音量

# 减少音量
cast.volume_down(delta=0.1)  # 减少10%音量

# 获取当前播放状态
status = cast.media_controller.status
print(f"当前状态: {status.player_state}")
print(f"当前时间: {status.current_time}秒")
if not status.is_live:
    print(f"总时长: {status.duration}秒")

错误处理与调试

添加错误处理和调试日志可以帮助你解决常见问题：

import logging
from pychromecast.error import ChromecastConnectionError, CastError

# 配置日志
logging.basicConfig(level=logging.DEBUG)
logger = logging.getLogger(__name__)

try:
    # 连接设备
    chromecasts, browser = pychromecast.get_listed_chromecasts(friendly_names=[CAST_NAME])
    if not chromecasts:
        logger.error(f"未找到设备: {CAST_NAME}")
        exit(1)
    
    cast = chromecasts[0]
    cast.wait(timeout=10)  # 增加超时时间
    
    # 播放媒体
    app_data = {
        "media_id": MEDIA_ID,
        "is_live": IS_LIVE,
        "metadata": METADATA
    }
    quick_play.quick_play(cast, "bbcsounds", app_data)
    logger.info(f"成功播放媒体: {MEDIA_ID}")
    
except ChromecastConnectionError as e:
    logger.error(f"连接错误: {str(e)}")
except CastError as e:
    logger.error(f"播放错误: {str(e)}")
except Exception as e:
    logger.error(f"发生意外错误: {str(e)}")
finally:
    browser.stop_discovery()

常见问题与解决方案

设备发现问题

问题解决方案
无法发现设备1. 确保计算机与Chromecast在同一网络
2. 检查防火墙设置，允许5353端口的UDP流量
3. 尝试使用IP地址连接：cast = pychromecast.Chromecast("192.168.1.100")
发现设备但连接失败1. 重启Chromecast设备
2. 确保Chromecast固件是最新版本
3. 检查网络稳定性
设备名称正确但无法连接1. 尝试使用已知IP地址连接
2. 清除DNS缓存
3. 重启路由器

播放问题

问题解决方案
媒体无法播放1. 验证media_id是否正确
2. 检查网络连接
3. 确认BBC Sounds服务是否可用
4. 对于非直播内容，确保is_live参数设为False
播放中断1. 检查网络稳定性
2. 减少网络拥堵
3. 确保计算机不休眠
元数据不显示1. 检查元数据格式是否正确
2. 确保图片URL可访问
3. 验证metadatatype是否设置正确

高级故障排除

如果遇到复杂问题，可以尝试以下高级故障排除步骤：

  1. 启用详细日志：
# 添加到脚本开头
import logging
logging.basicConfig(level=logging.DEBUG)
  1. 使用命令行工具检查网络：
# 检查mDNS发现
avahi-browse -r _googlecast._tcp

# 检查网络连接
ping <chromecast_ip>
telnet <chromecast_ip> 8009
  1. 重置Chromecast设备：
    • 按住Chromecast设备上的重置按钮约25秒，直到指示灯闪烁
    • 重新设置设备并重新尝试连接

总结与展望

通过本文，你已经掌握了使用PyChromecast库控制Chromecast设备播放BBC Sounds音频的完整流程。从环境搭建、设备发现、媒体ID获取，到自定义播放体验和故障排除，我们覆盖了实现这一功能所需的所有关键知识。

PyChromecast库不仅支持BBC Sounds，还可以控制Chromecast播放各种其他内容，如YouTube视频、本地媒体文件等。你可以探索库中的其他控制器，实现更多定制化功能，例如：

  • 创建一个定时播放特定节目的闹钟
  • 开发一个语音控制的音频播放系统
  • 构建一个多房间音频同步播放系统
  • 实现根据用户行为自动推荐和播放内容

希望本文能帮助你充分利用PyChromecast的强大功能，打造属于自己的智能音频播放体验。如果你有任何问题或发现新的使用技巧，欢迎在评论区分享！

附录：完整示例代码

BBC Sounds播放完整脚本

"""
使用PyChromecast播放BBC Sounds音频的完整示例
"""

import argparse
import sys
import json
import logging
from time import sleep

import pychromecast
from pychromecast import quick_play
from pychromecast.error import ChromecastConnectionError, CastError

# 配置日志
logging.basicConfig(level=logging.INFO)
logger = logging.getLogger(__name__)

def main():
    # 解析命令行参数
    parser = argparse.ArgumentParser(description="使用PyChromecast播放BBC Sounds音频")
    parser.add_argument("--cast", help="Chromecast设备名称", required=True)
    parser.add_argument("--media_id", help="BBC Sounds媒体ID", required=True)
    parser.add_argument("--title", help="显示的标题", default="BBC Sounds")
    parser.add_argument("--image_url", help="封面图片URL", 
                      default="https://sounds.files.bbci.co.uk/2.3.0/networks/bbc_radio_one/background_1280x720.png")
    parser.add_argument("--is_live", help="是否为直播内容", action="store_true")
    parser.add_argument("--debug", help="启用调试日志", action="store_true")
    args = parser.parse_args()

    # 调试模式
    if args.debug:
        logger.setLevel(logging.DEBUG)

    # 配置元数据
    metadata = {
        "metadatatype": 0,
        "title": args.title,
        "images": [{"url": args.image_url}]
    }

    try:
        # 发现并连接设备
        logger.info(f"正在寻找设备: {args.cast}")
        chromecasts, browser = pychromecast.get_listed_chromecasts(friendly_names=[args.cast])
        
        if not chromecasts:
            logger.error(f"未找到名称为'{args.cast}'的Chromecast设备")
            sys.exit(1)

        cast = chromecasts[0]
        
        # 等待连接建立
        logger.info(f"正在连接到: {args.cast}")
        cast.wait(timeout=10)
        logger.info(f"成功连接到设备: {cast.name} (型号: {cast.model_name})")

        # 准备播放参数
        app_name = "bbcsounds"
        app_data = {
            "media_id": args.media_id,
            "is_live": args.is_live,
            "metadata": metadata
        }

        # 发送播放请求
        logger.info(f"请求播放媒体: {args.media_id} (直播: {args.is_live})")
        quick_play.quick_play(cast, app_name, app_data)
        
        # 等待播放开始
        sleep(5)
        
        # 检查播放状态
        status = cast.media_controller.status
        if status.player_state == "PLAYING":
            logger.info(f"成功播放: {args.title}")
            logger.info(f"当前状态: {status.player_state}")
            if not args.is_live and status.duration:
                logger.info(f"总时长: {status.duration}秒")
            
            # 保持连接
            logger.info("按Ctrl+C停止播放并退出")
            try:
                while True:
                    sleep(1)
            except KeyboardInterrupt:
                logger.info("正在停止播放...")
                cast.media_controller.stop()
        else:
            logger.error(f"播放失败，当前状态: {status.player_state}")

    except ChromecastConnectionError as e:
        logger.error(f"设备连接错误: {str(e)}")
        sys.exit(1)
    except CastError as e:
        logger.error(f"播放错误: {str(e)}")
        sys.exit(1)
    except Exception as e:
        logger.error(f"发生错误: {str(e)}", exc_info=True)
        sys.exit(1)
    finally:
        # 清理资源
        if 'browser' in locals():
            browser.stop_discovery()
        logger.info("程序已退出")

if __name__ == "__main__":
    main()

使用方法

# 播放直播（BBC Radio 1）
python bbcsounds_player.py --cast "你的设备名称" --media_id "bbc_radio_one" --title "BBC Radio 1" --is_live

# 播放非直播内容
python bbcsounds_player.py --cast "你的设备名称" --media_id "m0015vcg" --title "BBC财经新闻"

【免费下载链接】pychromecast Library for Python 3 to communicate with the Google Chromecast. 【免费下载链接】pychromecast 项目地址: https://gitcode.com/gh_mirrors/py/pychromecast

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值