URLスキームガイド
このページでは、URLスキームを使ったうさプレイヤの制御方法を解説します。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と同じですが、playlist-rabbitの場合うさプレイヤ、playlist-itunesの場合iTunesのプレイリストからのみ検索します
また、曲指定オプション名にsを付けることで、名前に合致したもの1つではなくその名前を含むものすべてになります。
例えば、以下の場合、曲名に"雨"を含む曲すべてになります。
rabbitplayer://add?songs=雨
以下はsを付けた場合のオプション名リストです。
◆songs[ss]=名前
◆albums[as]=名前
◆artists[as]=名前
◆tags[ts]=名前
◆playlists[ps]=名前
◆playlists-rabbit[psr]=名前
◆playlists-itunes[psi]=名前
