SoCo下载 - SoCo源码下载

SoCo

其他源码

SoCo 0.30.6 Release Notes

下载

索科

SoCo（Sonos 控制器）是一个 Python 库，允许您以编程方式控制 Sonos 扬声器。它最初是由 Rahim Sonawalla 在悉尼音乐黑客日创建的，现在由一个团队在其 GitHub 存储库中开发

有关该项目的更多背景信息，请参阅 Rahim 的博客文章。

请访问 SoC 文档以获取更详细的功能概述。

警告

Sonos 改变了音乐服务帐户信息的获取方式。这意味着目前一组音乐服务会出现身份验证问题，根本无法使用。该组织的已知成员包括：Google Play Music、Apple Music、Amazon Music、Spotify 和 Napster。

问题 #557 是此问题的元问题，您可以使用它来跟踪解决问题的进度，但请不要在那里发布“我也是”评论。此外，没有必要就此提出任何更多单独的问题。如果您有其他音乐服务应该出现在列表中，请在 #557 中发表评论

从 v0.26.0 开始，新的音乐服务支持已恢复，但存在一些已知问题。测试和问题报告将不胜感激。

安装

SoCo 需要 Python 3.6 或更高版本。

使用点：

pip install soco

SoCo 依赖于许多 Python 包。如果您使用 pip 安装 Soco，则会自动为您安装依赖项。如果没有，您可以检查requirements.txt 文件中的要求。

基本用法

您可以通过 SoC 对象与 Sonos Zone Player 进行交互。如果您知道Zone Player的IP地址，则可以直接创建一个SoC对象：

 >> > from soco import SoCo
>> > my_zone = SoCo ( '192.168.1.101' )
>> > my_zone . player_name
Kitchen
>> > my_zone . status_light = True
>> > my_zone . volume = 6

但也许最简单的方法是使用模块级发现功能。这将找到网络上的所有区域播放器，并返回包含它们的 python 集：

 >> > from soco import discover
>> > for zone in discover ():
...        print ( zone . player_name )
Living Room
Kitchen

如果您更喜欢列表而不是集合：

 >> > zone_list = list ( discover ())
>> > zone_list
[ SoCo ( "192.168.1.101" ), SoCo ( "192.168.1.102" )]
>> > zone_list [ 0 ]. mute = True

当然，你还可以播放音乐！

 #!/usr/bin/env python
from soco import SoCo

if __name__ == '__main__' :
    sonos = SoCo ( '192.168.1.102' ) # Pass in the IP of your Sonos speaker
    # You could use the discover function instead, if you don't know the IP

    # Pass in a URI to a media file to have it streamed through the Sonos
    # speaker
    sonos . play_uri (
        'http://ia801402.us.archive.org/20/items/TenD2005-07-16.flac16/TenD2005-07-16t10Wonderboy.mp3' )

    track = sonos . get_current_track_info ()

    print ( track [ 'title' ])

    sonos . pause ()

    # Play a stopped or paused track
    sonos . play ()

支持

如果您需要 SoCo 的支持，请随时在 SoCo Gitter Room 中发布您的问题。

应用示例

为了展示可以使用 SoCo 制作的内容， examples夹中包含了一个简单的 Web 应用程序。

网络应用程序的屏幕截图

特征

SoCo 支持以下控件：

播放、暂停、停止
下一曲目、上一曲目
音量获取和设置
静音（或取消静音）
获取当前传输信息（扬声器是否正在播放、暂停或停止）
获取有关当前播放曲目的信息
- 曲目标题
- 艺术家
- 专辑
- 专辑封面（如果有）
- 轨道长度
- 播放时长（例如，3 分钟歌曲中的 30 秒）
- 播放列表位置（例如播放列表中的项目 5）
- 追踪 URI
当玩家状态改变时接收事件
搜索并播放音乐项目：
- 本地音乐库
- 通过 TuneIn 的 Webradio 和音乐服务（仍然不稳定）
- 已保存 Sonos 收藏夹、最喜爱的广播电台和节目
将扬声器源切换至线路输入或电视输入（如果 Zone Player 支持）
管理 Sonos 队列：
- 获取队列中的项目
- 将项目添加到队列中
- 清空队列
- 播放队列中的特定歌曲
加入或取消加入群组中的发言者
将网络中的所有 Sonos 扬声器置于“派对模式”。
获取或设置闹钟
获取或设置睡眠定时器
启用或禁用环绕扬声器或低音炮
获取有关家庭影院设置的信息：
- 如果环绕扬声器或低音炮已配对
- 给定扬声器处理哪个音频通道
获取或设置扬声器的低音和高音均衡器
切换扬声器的响度补偿、夜间模式和对话模式
切换设备上的白色状态灯
获取演讲者信息
- 区域名称
- 区域图标
- UID（通常类似于 RINCON_XXXXXXXXXXXXXXXXX）
- 序列号
- 软件版本
- 硬件版本
- MAC地址
设置扬声器的区域名称
启动音乐库更新并确定是否正在进行更新