> ## Documentation Index
> Fetch the complete documentation index at: https://docs.archetype.ing/llms.txt
> Use this file to discover all available pages before exploring further.

# ミュージック

> MacのSpotifyやApple Musicで再生中の曲を確認して操作し、頼んだ曲をエージェントに再生させます。

ミュージックは、Macの音楽アプリ、つまりSpotifyとAppleのミュージックを表示して操作します。ミュージック自体はストリーミングをせず、アカウントもキーも必要ありません。Archetypeに付属しており、デフォルトでオンです。macOSでのみ動作します。全般的な設定は[プラグイン](https://docs.archetype.ing/ja/extend/plugins.md)を参照してください。

## サイドバー

**ミュージック**には、再生中の曲がアートワーク、シークバー、操作ボタン、音量とともに表示され、インストールされているアプリを切り替えられます。

* **Spotify**：Spotifyのリンクを貼り付けて再生するか、検索します。
* **Apple Music**：ライブラリを検索し、プレイリストを再生します。

ページを表示している間、2秒ごとにアプリの状態を読み取ります。閉じているアプリは、エラーではなく、開いていないものとして表示されます。

## Archetypeにアプリの操作を許可する

初回は、ArchetypeにSpotifyやミュージックの操作を許可するかどうかをmacOSが尋ねます。許可してください。以前に拒否した場合は、**システム設定 → プライバシーとセキュリティ → オートメーション → Archetype**を開き、そのアプリをオンにします。許可されていないときは、ページにこの手順が表示されます。

## エージェントができること

| ツール | 動作 |
| - | - |
| `now_playing` | 今何がどこで再生されているか。読み取りのみです。 |
| `search_music_library` | ミュージックのライブラリから曲を探します。読み取りのみです。 |
| `list_music_playlists` | ミュージックのプレイリストの一覧を表示します。読み取りのみです。 |
| `control_music` | 再生、一時停止、次へ、前へ、シーク、音量、シャッフル、リピート。 |
| `play_music` | Spotifyのリンク、ミュージックの曲、ミュージックのプレイリストを再生します。 |

プラグイン自体は、`control_music`や`play_music`の前に確認を求めません。

## 設定

| 設定 | 内容 |
| - | - |
| **Music app**（`player`） | どちらも再生していないときにページに表示するアプリ：`auto`、`spotify`、`music`。どちらかが再生中なら、そのアプリが表示されます。 |

または`~/.config/archetype/config.json`で設定します：`"plugins": { "music": { "player": "spotify" } }`。

## オフにする

**管理 → プラグイン**でオフにするか、`"plugins": { "music": false }`を設定します。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.