PLUGIN/2.0/iSing4u の編集

*iSing4u ～ Now Playing ～ [#vba3eea0]

iTunesで再生中の曲の情報を通知するプラグインでした。~

新規イベントとかは [[iSing4u/作業所>PLUGIN/2.0/iSing4u/作業所]] で考え中。

**重要なこと [#t389c5e9]

&color(Red){''2.1.7.0 より前のバージョンにはメモリリークするバグがあります。最新版に更新してください。''};

制御イベントは''SSP 2.00.00 RC2以降''じゃないと''動作しません。''

*通知・制御イベント [#f5bd6e25]

**OnMusicPlayEx [#r39661ea]

曲の再生開始時に通知されます。~
（一時停止を解除した際も通知されます）

Reference0：曲名
 Reference1：アーティスト名
 
 ReferenceX：album[1]アルバム名
 ReferenceX：genre[1]ジャンル名
 ReferenceX：rating[1]レート（マイレート）
 ReferenceX：playcount[1]再生回数
 ReferenceX：composer[1]作曲者名
 ReferenceX：duration[1]曲の長さ
 ReferenceX：uniqueid[1]ユニークID
 ReferenceX：playlist[1]ソース[1]プレイリスト名[1]曲数[1]種類[1]再生時間(秒)[1]再生制御設定

曲名とアーティストのRef番号は固定ですが、その他の情報は拡張情報として扱われ「項目名\1(バイト値1)情報」のような形になります。

プレイリスト情報については、下のOnITunesPlaylistCollectionも参照してください。

レート（マイレート）は0 ～ 100で表現されます。

\![raiseplugin,6BDC58E1-2D7F-47f0-A74F-804F53A66A53,OnMusicPlayEx]

を実行すると、実行した時点での再生中の情報が同名のイベントで戻ります。

**OnITunesPlaylistCollection [#bc8d13be]
現在iTunesにどのようなプレイリストがあるかどうかを調べます。
 \![raiseplugin,6BDC58E1-2D7F-47f0-A74F-804F53A66A53,OnITunesPlaylistCollection]
を実行すると、OnITunesPlaylistCollectionがゴーストに通知されます。

Reference0からひとつずつプレイリストが列挙されます。

ReferenceX：ソース[1]プレイリスト名[1]曲数[1]種類[1]再生時間(秒)[1]再生制御設定

の形式となります。

「種類」は以下の通りです。

-Unknown - 不明
-Library - ライブラリ
-SmartPlaylist - スマートプレイリスト
-Playlist - 通常のプレイリスト
-PurchasedMusic - 購入した音楽
-PartyShuffle - パーティーシャッフル
-Podcasts - ポッドキャスト
-Folder - フォルダ
-Videos - ビデオ
-Music - 音楽
-Movies - 映画
-TVShows - Apple TV
-Audiobooks - オーディオブック
-CD - 音楽CD
-Device - デバイス
-RadioTuner - ラジオ

「再生制御設定」は以下の通りです。なお、カンマ区切りで複数が列挙される可能性があります。（例：shuffle,repeat）
-shuffle - ランダム再生

-repeat - 繰り返し
-repeatone - 1曲のみ繰り返し

再生するプレイリストはReferenceつきのOnITunesPlayで切り替えられます。

**OnITunesArtistCollection [#kd2733a5]

アーティストのコレクションを取得。

Reference0: ソース名
 Reference1: プレイリスト名

**OnITunesAlbumCollection [#vcc50f65]

アルバムのコレクションを取得。

Reference0: ソース名
 Reference1: プレイリスト名
 Reference2: アーティスト名（省略可）

**OnITunesTrackCollection [#i6dcf87d]

トラックのコレクションを取得。

Reference0: ソース名
 Reference1: プレイリスト名
 Reference2: アーティスト名（省略可）
 Reference3: アルバム名（省略可）

トラックのリストは

ReferenceX: トラック名[1]ID

の順で列挙される。

**OnITunesEqualizerCollection [#mf1bd560]
現在iTunesにどのようなイコライザ設定があるかどうかを調べます。
 \![raiseplugin,6BDC58E1-2D7F-47f0-A74F-804F53A66A53,OnITunesEqualizerCollection]
を実行すると、OnITunesEqualizerCollectionがゴーストに通知されます。

Reference0からひとつずつイコライザの設定名が列挙されます。

OnITunesEqualizerで設定ができます。

**OnITunesPlayerState [#x16da5a3]
iTunesが起動しているか、起動しているなら再生中かどうか、を調べます。
 \![raiseplugin,6BDC58E1-2D7F-47f0-A74F-804F53A66A53,OnITunesPlayerState]
を実行すると、OnITunesPlayerStateがゴーストに通知されます。

Reference0 : stopped / playing / not exist / not install

のどれかの情報が入ります。

-stopped - 停止中
-playing - 再生中
-not exist - 起動していない
-not install - そもそもインストールしていない

**OnITunesBoot [#ta5c5c94]

iTunesが起動した時に通知されます。~
referenceはありません。

\![raiseplugin,6BDC58E1-2D7F-47f0-A74F-804F53A66A53,OnITunesBoot]

を実行すると、iTunesを起動することもできます。

**OnITunesExit [#sa715ebb]

iTunesが終了したときに通知されます。~
referenceはありません。

\![raiseplugin,6BDC58E1-2D7F-47f0-A74F-804F53A66A53,OnITunesExit]

を実行すると、iTunesを終了することもできます。

*制御イベント [#kbb3a28a]

\![raiseplugin]で使用できるイベントです。

例：\![raiseplugin,6BDC58E1-2D7F-47f0-A74F-804F53A66A53,OnITunesPlay]

**OnITunesPlay [#q2818159]

再生します。一時停止状態の解除も含みます。

Reference0 : 再生するファイル名

のようにReferenceを追加指定すると、指定されたファイルをライブラリに追加したうえで、再生します。

Reference0 : ソース
 Reference1 : プレイリスト名

のようにReferenceを追加指定すると、再生するプレイリストの切り替えとなります。

Reference0 : ソース
 Reference1 : プレイリスト名
 Reference2 : ユニークID

のようにReferenceを追加指定すると、指定されたユニークIDを持つ曲を再生します。

**OnITunesStop [#wed3f16d]
停止します。

**OnITunesPause [#hb5bf02f]
一時停止します。

**OnITunesResume [#i2a1daa9]
一時停止状態を解除します。

**OnITunesNextTrack [#f0993685]
次の曲に進みます。

**OnITunesPrevTrack [#k42d9927]
前の曲に戻ります。

**OnITunesHeadTrack [#s09bfc91]
再生中の曲の先頭に移動します。

**OnITunesEqualizer [#z048c104]
現在のイコライザ設定を切り替えます。

Reference0 : OnITunesEqualizerCollectionで取得した設定名

referenceなしで実行すると、現在のイコライザ設定名が返ります。

Reference0: Rock

**OnITunesPlaylistConfig [#u2a59fe6]

プレイリストの情報を設定。主に再生制御用。

Reference0: ソース名
 Reference1: プレイリスト名
 
 ReferenceX: shuffle[1](true|false)
 ReferenceX: songrepeat[1](off|one|all)

**OnITunesTrackConfig [#r9733ba9]

トラックの情報を設定。主に評価設定用。

Reference0: ソース名
 Reference1: プレイリスト名
 Reference2: ユニークID
 
 ReferenceX: rating[1]0～100

*対応ゴースト [#i37ca6fa]

バージョン 2.1.5.0からはデフォルトスクリプトを付加するようにしているので、対応していないゴーストでも通知されます。

#showrss(http://marble.tarenari.jp/selection/show/43/rss,default,24,1)

[[iSing4u対応ゴースト検索>http://marble.tarenari.jp/selection/show/43]]

タイムスタンプを変更しない