■■■ URLスキームとは ■■■

URLスキームはURLを使ってアプリを起動するための仕組みです。また、URLにパラメータを付加することで、アプリを制御することにも使うことができます。
うさプレイヤでは、バージョン1.3.0からURLスキームに対応しました。

■■■ URLスキームの使い方 ■■■

- iOSのSafariのアドレス欄に入力
- ランチャーアプリを利用する

■■■ 基本フォーマット ■■■

■コマンド1つを実行
rabbitplayer://コマンド名

■コマンド1つをオプション付きで実行
rabbitplayer://コマンド名?オプション名=値

■コマンド1つを複数のオプション付きで実行
rabbitplayer://コマンド名?オプション名1=値&オプション名2=値

■複数のコマンドを実行
rabbitplayer://コマンド名1?オプション名=値;コマンド名2

※オプションの「値」の部分に日本語や記号などを含める場合は、URLエンコードによる変換を行っておく必要があります。
※ただし、Safariのアドレス欄から実行する場合は自動でURLエンコードされるようです。

■■■ 使用例 ■■■

■単純な起動
rabbitplayer://

■再生
rabbitplayer://play

■一時停止
rabbitplayer://pause

■現在再生中の曲にLike
rabbitplayer://like

■再生リストをクリア
rabbitplayer://clear

■再生リストにタグ"サントラ"のすべての曲を追加
rabbitplayer://add?tag=サントラ

■再生リストをクリア後、タグ"サントラ"のすべての曲を追加し、再生を開始
rabbitplayer://clear;add?tag=サントラ;play

■■■ 全コマンドリスト ■■■

[]内は省略形です。省略形もコマンド名として利用可能です。

■play[p]
再生します

■play-toggle[pt]
再生と一時停止を切り替えます

■pause[pa,stop,s]
一時停止します

■next[n]
次の曲を再生します

■prev[back,b]
前の曲を再生します

■like[l]
現在再生中の曲にLikeを付けます

■dislike[d]
現在再生中の曲にDislikeを付けます

■set?設定オプション
各種設定を変更します。以下のオプションが利用できます。

---------- 設定オプション ----------
setコマンドで使用できる設定オプションの一覧です。

以下のように使用します。
rabbitplayer://set?repeat=all

◆repeat=(none,one,all)
リピートモードを切り替えます

◆random=(none,shuffle,random)
ランダムモードを切り替えます

◆crossfade=(on,off)
クロスフェードのON/OFFを切り替えます

◆reverb=(on,off)
リバーブ(残響)のON/OFFを切り替えます

◆eq=(on,off)
イコライザーのON/OFFを切り替えます
-------------------------------------

■clear[c]
再生リストをクリアします

■add[a]?曲指定オプション
再生リストに曲指定オプションの曲を追加します(重複追加されません)

※曲指定オプションについては後述します。

■add-force[af]?曲指定オプション
addと同じですが、重複追加可能です

■remove[r]?曲指定オプション
再生リストから曲指定オプションの曲を取り除きます

■filter-include[fi]?曲指定オプション
再生リストを曲指定オプションの曲のみにします

■filter-exclude[fe]?曲指定オプション
再生リストを曲指定オプションの曲以外のみにします(removeと同じ)

--------------- 曲指定オプション ---------------
add,add-force,remove,filter-include,filter-excludeコマンドで使用できる曲指定オプションの一覧です。

以下のように使用します。
rabbitplayer://add?tag=サントラ

◆song[s]=名前
指定の名前に最も合致する1曲

◆album[a]=名前
指定の名前に最も合致するアルバム1枚

◆artist[ar]=名前
指定の名前に最も合致するアルバム1枚

◆tag[t]=名前
指定の名前に最も合致する1つのタグのすべての曲

◆playlist[p]=名前
指定の名前に最も合致する1つのプレイリスト(うさプレイヤとiTunes)のすべての曲

◆playlist-rabbit[pr]=名前
◆playlist-itunes[pi]=名前
playlistと同じですが、-rabbitの場合うさプレイヤ、-itunesの場合iTunesのプレイリストからのみ検索します

また、曲指定オプション名にsを付けることで、名前に合致したもの1つではなくその名前を含むものすべてになります。
例えば、以下の場合、曲名に"雨"を含む曲すべてになります。
rabbitplayer://add?songs=雨

以下はsを付けた場合のオプション名リストです。

◆songs[ss]=名前
◆albums[as]=名前
◆artists[as]=名前
◆tags[ts]=名前
◆playlists[ps]=名前
◆playlists-rabbit[psr]=名前
◆playlists-itunes[psi]=名前
---------------------------------------------