/* ---------------------------------------------------------- */
◆◇◆◇◆◇◆◇◆◇◆◇◆◇◆◇◆◇◆◇◆◇◆◇◆◇◆◇◆◇◆◇
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

【 ソフト名 】anko2タイマー
【 作 成 者 】うつろ
【  種  別  】やります！アンコちゃん plugin
【 開発環境 】Visual Studio 2010 Professional .NET Framework 4 C#
【 動作環境 】やります！アンコちゃんが正常に安定動作する環境
【バージョン】1.5
【最終更新日】2012-06-24
【ファイル名】anko2Timer.dll

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
◆◇◆◇◆◇◆◇◆◇◆◇◆◇◆◇◆◇◆◇◆◇◆◇◆◇◆◇◆◇◆◇


《概要》
30分を1単位とし、指定された残り時間にコメントをしたり効果音を鳴らしたりするプラグイン。


《動作条件》
windows xp sp3
windows vista sp2
windows 7 sp1
.NET Framework 4 Extended インストール必須。
やります！アンコちゃん2.0.35.16以降。
（2.0.35.15以前は設定できません）
（2.0.34以前と互換性がありません）


《インストール》
anko2Timer.dllをアンコちゃんのpluginsフォルダに入れてください。
アンコちゃんを起動して、プラグイン一覧に「タイマー」と表示されていればインストールは完了です。


《アップグレード》
アンコちゃんが起動していたら終了します。
anko2Timer.dllをアンコちゃんのpluginsフォルダに入れ上書き保存してください。
ankoTimer2.dllがあったら削除してください。古いバージョンのタイマーです。
アンコちゃんを起動して、プラグイン一覧に「タイマー」と表示されていればインストールは完了です。


《アンインストール》
anko2Timer.dllを削除してください。
設定内容も削除したい場合はsereneConfig.dbを削除してください。
（うつろが作成した他のプラグインの設定もsereneConfig.dbに記録されています）


《使い方》
アンコちゃんのメニューから「プラグイン」->「タイマー」を選択するとタイマーリストが表示されます。
「追加」ボタンを押すと設定画面が表示されます。
「タイマー」「コメント」「効果音」「プログラム」4つのタブで各設定をします。

□タイマータブ
タイマー時間をセットしてください。
「放送を延長した後も作動させる」をチェックすると経過時間30分を超えても動作します。
フィルターを設定すると条件に合う場合のみタイマーが作動します。
「コミュニティー」にコミュニティーIDを入力しておくとそのコミュニティーのときに作動します。
さらに「番組名」で絞り込みが可能です。
コミュニティーIDや番組名の前に!を付けるとNOTフィルターになります。
（「!co235502」と入力するとこのコミュニティーでは作動しない）
（「!co235502/co211767」のように通常フィルターとNOTフィルターを同時設定しないでください）
コミュニティーフィルターは完全一致、番組名フィルターは部分一致の動作です。

□コメントタブ
タイマーでコメントする場合は「コメントする」をチェックします。
コマンドとコメントをそれぞれ設定してください。
コメントは改行付可能です。
「運営コメント」は運営コメントで投稿します。
「BSPコメント」は生放送主、リスナー共使用できます。
色はBSPコメントで使用します。
「名前」は名前付運営コメントやBSPコメントで使用します。
リスナーのBSPコメントは権限がないと投稿できません。

□効果音タブ
タイマーで効果音を鳴らす場合は「効果音を鳴らす」をチェックします。
「参照」より鳴らしたい効果音ファイルを選択します。
音量をセットします。
「再生」でテストできます。テストが終わったら「停止」を押してください。
「他の効果音は止める」にチェックすると他のタイマー設定で鳴らしている効果音を止めることができます。

□プログラムタブ
タイマーでプログラムを起動する場合は「プログラムを起動する」をチェックします。
「参照」より起動したいexeファイルを選択します。
「引数」がある場合は適切に入力します。
「テスト」でプログラムを起動することができます。

各設定が終わったら「OK」を押してください。
タイマーリストに追加されます。
追加できない場合はステータスバーにその理由が表示されます。

タイマーを作動させたい設定の「有効」にチェックを入れます。
タイマーを作動させるときは「開始」ボタンを押します。
開始できない場合はステータスバーにその理由が表示されます。
タイマーがスタートすると作動中になります。設定画面を閉じてください。

不具合など見つけましたらコミュニティーの掲示板にお願いします。


□コメントについて
特殊コメント1（現在日時の書式）
%D → %Y/%m/%d
%T → %H:%M:%S
%Y → 年(西暦4桁)
%m → 月(01〜12)
%d → 日(01〜31)
%H → 時(00〜23)
%M → 分(00〜59)
%S → 秒(00〜59)

特殊コメント2（経過時間の書式）
%P  → %pH:%pM:%pS
%pH → 時( 0〜48)
%pM → 分(00〜59)
%pS → 秒(00, 15, 30, 45) or (00〜59)

特殊コメント3（残り時間の書式）
%R  → %rM:%rS
%rM → 分(00〜30)
%rS → 秒(00, 15, 30, 45) or (00〜59)

特殊プログラム引数
%id   → 生放送ID
%coid → コミュニティーID


《制限事項》
アンコちゃんのメインフォームに表示されている生放送に対してのみタイマーは動作します。
タイマー時間が数秒ずれているかのようにみえないかもしれない。
指定分0の時、指定秒は0〜60まで指定できますが秒刻みの実行はできません。
「プログラムの起動」は初期状態では動作しません。


《プログラムの起動有効化》
設定ファイル「sereneConfig.db」と同じフォルダに空ファイルを作成してください。
ファイル名は生放送に接続しているコミュニティーIDです。
（たいていは「co○○○○」という名前のファイルで拡張子なしになります）
尚、この機能についてのサポートはしませんし質問されてもお答えいたしません。
適切なプログラムパスと引数を設定してください。


《現在判明している不具合》
連続枠取りすると開始してくれないかもしれない。（直したつもり）
なぜか固まってどうしようもなくなることがある。（私の環境のみ起こり他の報告は受けておりません）


《設定移行手順》
バックアップ → アンコちゃんのメニュー「ファイル」→「設定フォルダーを開く」のフォルダを上にたどりpluginsフォルダにあるsereneConfig.dbをどこかに保存。
リストア     → どこかに保存したsereneConfig.dbを移行先のアンコちゃんメニュー「ファイル」→「設定フォルダーを開く」のフォルダを上にたどりpluginsフォルダに入れる。


《免責》
プラグインの品質が悪いのでフリーズする可能性があります。
何らかの影響によりお使いのPCに不具合が発生するかもしれません。
これらによる付随的または間接的損害について、一切責任を負いませんので予めご了承ください。
バグ修正を必ず行なうお約束はできません。
要望をいただいても実装するかどうかは気分しだいです。


《注意事項》
タイマーを使い悪戯などしないでください。


《禁止事項》
readme自体を盗用されましたのでこれからはプログラムやそれに付随する文章等
すべてにおいて無断での転載・配布を一切禁止させていただきます。
ご不便をおかけしますがご理解ください。
なお、紹介のためのスクリーンショットの掲載またはreadmeの引用は制限いたしません。


《他の著作権情報》
フォームタイトルバーの時計アイコン clock-frame
Copyright (C) 2010 Yusuke Kamiyamane
<http://p.yusukekamiyamane.com/>
The icons are licensed under a Creative Commons Attribution 3.0 license.
<http://creativecommons.org/licenses/by/3.0/>


《その他》
設定ファイル名は「sereneConfig.db」です。



-- 
_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/

□ 連絡先 □
http://com.nicovideo.jp/community/co235502
mailto:utsuro.youyou@gmail.com


□ 更新履歴 □
2012-06-24 Ver.1.5
リビルド

2012-06-09 Ver.1.4
2.0.35.11以降の高速起動に対応。
同じ時間の設定が複数あるときランダムに実行する機能（どれか一つの設定）を追加。

2012-04-30 Ver.1.3
2.0.35.3ベータ以降のプラグイン仕様変更に対応。

2012-02-02 Ver.1.2
ショートカットに対応（Ctrl+Shift+T）

2011-10-09 Ver.1.1.1.1
Vector公開用

2011-10-09 Ver.1.1.1
名前ルール変更。（プラグイン名です）

2011-10-05 Ver.1.1
プログラム起動機能追加。
微調整。

2011-08-18 Ver.1.0.1
見直し。

2011-08-18 Ver.1.0
公開。

_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/
EOF