rankview.phpに続いて渡すと効果があるかもしれない引数一覧 ここに載っていない引数はほぼ存在しません。自分用メモなので。 ＠注意 アンカーで辿れる場所やフォームから実行されるもの以外の引数は、 デバッグが甘いとか一般向けでないなどの理由で表に出ていない 「隠し引数」です。使うのは勝手ですが、正しい表示にならないなど の不具合が発生する可能性があります。あと、追加処理が行われる オプション(usecategoryとか)は、追加すればするほど処理時間が 延びます。実装が糞だからです←結論 ただし、同じ日に誰かが全く同じパラメータですでに処理を行って いた場合、キャッシュを利用するのでそこそこ速く処理が完了します。 この場合は引数による差は無いといっていいでしょう。運ですが。 デフォルトのパラメータなどは検索ロボットが巡回する場合などにも 処理されるため、低負荷で表示できる可能性が意外と高かったりします。 外部からの使用は自由ですが、元のデータの著作権が動画投稿者に、 データベース著作権がニコニコ動画/ニワンゴにあることと、 当システムに過負荷をかけないようなシステムを組むことに注意して いただけると幸いです。 ＠標準倍率について 各期間のランキングを指定する際に各種倍率を指定しなかった場合、 参考もとのランキングに最も近くなるように勝手に倍率が設定されます。 現在はマイリストについてのみ、以下のようになっています。 毎時：10倍 新着：15倍 日刊：15倍 週刊：20倍 月刊：20倍 通算：20倍 それ以外の倍率でランキングを閲覧したい場合は、自身で倍率を指定する 必要があります。また、倍率以外の設定は(プリセットを使った場合を除き) 週刊と同一の設定になります。 ＊凡例 example (true|[false]) 引数ととりうる値の例です。この場合、引数exampleにtrueまたは falseを渡すとそれぞれ効果があることを示します。小文字文字列や 数字は、それそのものが値です。指定しない場合、[]で囲まれている 方の値(ここではfalse)を指定したのと同じ事になります。 example (NN) この場合、NNには最大2桁の数字が入ります。大文字は数字です。 example (N) 一桁の場合は、Nには桁数無制限の数字が入ります。 ただし、PHPでの計算範囲の制限を越えることは出来ません。 通常は自然数のみですが、実数が使える場合もあります。 example (10item->title要素から順位表示を取り除きます。 指定するだけで取り除かれます。trueとかfalseとか関係ないです。 smallbox (true|[false]) output=boxのとき、出力するHTMLを簡略化したものに変更します。 iframeを使用する際に、より小さな枠表示にすることが出来るようになります。 ちなみに、falseのときはニコニコ動画オフィシャルの貼り付けHTMLと 同じ大きさに最適化されています。具体的には、 trueのとき：172x110 falseのとき：312x176 を想定した大きさです。なお、動画説明文などが長すぎるとデザインが 崩れたりする可能性があるので、個人的にはiframeの要素に scrolling="no"を指定することをお勧めしておきます。 deny_bkstar (N) output=htmlの時に、★の数に応じて表示を目立たなくさせるかどうかと その閾値を指定します。指定するのは数字で、その値と同じ数か それ以上の数の★がついている動画に関して、表示を130位相当の 動画と同じ状態にします。 表示の制御はスタイルシートで行われるため、CSS非対応ブラウザでは 効果がありませんが、ニコニコ動画を見るブラウザがCSS非対応である ケースはまずないと思うのでたぶん問題ないでしょう。 bs_rp (N) bs_mp (N) bs_dp (N) bs_exp (N) bs_lp (N) output=htmlの時に、★の倍率を操作します。特定の値を強調したり 除外したりするのに使用できます。値の意味は上からコメント率、 マイリス率、経過日数、!、タグロック数のそれぞれの倍率です。 例えば、bs_dpに0を指定すると、日数経過による★の追加はなくなります。 逆に、倍率を上げて星を増やしたりすることも出来ます。バランスに よっては面白い傾向が現れたりすることがあったりするかもしれませんし、 無いかもしれません。 noscale (true|[false]) output=htmlの時に、サムネイル画像や文字列の順位変動もしくは 動画が削除されることによる縮小表示をやめて、常に1位と同じ大きさで 描画するようにします。また、通常101位以降では表示されない最新コメントも これを指定している場合は130位まで全て表示されます。 なお、deny_bkstarはこれの効果では抑制されません。 targetid (？) 注目したい動画IDを指定します。output=htmlのときに指定した 動画が集計範囲内に存在していた場合、ランキングの一番上でその 動画のタイトルと順位を表示します。130位以内に入っている必要は なく、最大集計範囲(その日のランキングによるので一概には言えませんが、 カテゴリ込みならデイリーで毎回数千位くらいまで)ならば表示されます。 tagrank (true|[false]) output=htmlの時に、プリセットとタグ一覧のどちらを優先して 表示するかを決定します。trueならタグ表示優先、falseなら プリセット優先です。ただし、どちらも「タグ一覧」などのタイトルを クリックすることで表示・非表示を切り替えることが出来ます。 タグ一覧表示は、ランキングに載っている範囲の動画につけられているタグを 集計したものです。表示方法は次項のtagcloudに依存します。 tagcloud ([true]|false) output=htmlでtagrank=trueの時に表示するタグ一覧を、タグクラウド方式で 表示するかどうかを決定します。trueならタグクラウド表示、falseなら 登録タグ数の多い順に一覧表示されます。 start (N) limit (N) output=iphoneの時に、表示開始する順位と出力するアイテムの数を 指定します。1-100の間で指定。例えば、start=21でlimit=10を指定すると、 21位から30位までのランキングと31位から10アイテム表示するための アンカーが出力されます。 なお、ランキング出力が途中で終了した場合(「kwd指定してて上の例の ような引数指定の時に、25位でランキングが終わってた」など)、 続きへのアンカーは出ません。 ＠廃止された引数 output=tag プリセットの代わりにタグランキングを表示する HTML版に統合したので廃止。tagrank=trueを指定すると同等のランキングが 表示できます。 resonly 補正値が有効なときに、補正値が0になってしまう＝コメントでのみ ポイントが得られている場合に、補正を取りやめるかどうかを指定 出来る引数でした。ccmode=0で同等の設定が出来ます。 ＠おまけ：getthumbinfoAPI http://www.nicovideo.jp/api/getthumbinfo/(id)　とほぼ同等の情報を、 http://tsukaban.dyndns.org/~tsukaban/nknkrank/thumb.php?id=(id)　でも取得できます。 ほとんど違いはありませんが、後者はその動画についているタグの記事がニコニコ大百科に 存在しているかどうかの情報が nicovideo_thumb_response->thumb->tags[0]->tag['nicopedia'] に含まれています。0なら存在せず、1なら存在します。なお nicovideo_thumb_response->thumb->tags[0] は通常domain="jp"のタグ一覧ですが、ニコニコ動画サイドの仕様変更その他の理由により 必ずしもそうであることは保証しません。 ちなみにエラー時は、ニコニコ動画側のエラーの場合は通常と同じエラーコードが発行され、 sodiumサーバー側のエラー時は同一フォーマットで以下のエラーコードが発行されます。 INVALID_PARAMETER 指定されたパラメータに不正や不足がある なお、現在のところIDが指定されていない場合のみ表示されます。