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位址
設定揚聲器的區域名稱
啟動音樂庫更新並確定是否正在進行更新