iOS用音楽プレイヤー「うさプレイヤ」公式サイト

クロスフェード再生対応のiOS用音楽プレイヤー「うさプレイヤ」の公式サイトです。

URLスキームガイド

このページでは、URLスキームを使ったうさプレイヤの制御方法を解説します。URLスキームガイドはアプリ内からも見ることができます。

URLスキームの使い方

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

基本フォーマット

コマンド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]=名前