# NicoRo α版 ヘルプ

更新履歴

## アプリ概要

非公式なニコニコ動画再生アプリです。
あなたのAndroidでFlash Playerが使えるようになるまでのお茶濁しにご使用ください。
色々と残念な部分があるのは仕様です。

## 使い方

### ブラウザ部分

アプリを起動すると、画面中央にブラウザ部品でニコニコ動画のサイトを表示します。
リンクをたどって動画のあるページを開くと、画面下に再生ボタンとキャッシュボタンが出てきます。
再生ボタンを押すとプレイヤーを起動して動画の再生を試みます。
試みなので時々失敗します。swf形式の動画は再生できません。
キャッシュボタンを押すとバックグラウンドでキャッシュのダウンロードを試みます。キャッシュが完了すると画面上部のステータスバーに通知が表示されます。通知をタップするとその動画のページにジャンプします。

メニューキーを押すとメニューが出てきます。次の項目が使用できます。

ブックマーク
  現在表示中のページのブックマーク、および過去にブックマークしたページの表示ができます。
  データは標準ブラウザのものと共有です。
  .nicovideo.jpを含むURLのみ扱います。
再読込
  現在表示中のページを再読み込みします。
設定
  オプション変更画面を表示します。
ヘルプ
  ヘルプ（今の画面）を表示します。
終了
  アプリを明示的に終了させます。
その他
  TOP
    ニコニコ動画のトップページに移動します。変なところに迷い込んで戻れなくなったときにご使用ください。
  キャッシュをクリア
    ストレージ（多くの場合はSDカード）に保存したキャッシュをすべて削除します。いきなり動画が再生できなくなった場合等に試してみてください。

### オプション部分

#### 一般設定

ヘルプボタン表示
  ブラウザ画面でヘルプボタンを表示します。
ヒント表示
  要所で操作のヒントを表示します。邪魔に感じたらOFFにしてください。
MediaPlayer使用
  mp4動画の再生にMediaPlayerを使用します。flv動画はこの設定に関係なくFFmpegで再生を行います。
コメント アンチエイリアス使用
  コメントのテキスト描画にアンチエイリアスを使用します。綺麗になりますが、FFmpeg使用での重い動画の再生がさらに残念なことになります。
コメント 非表示
  コメントを一律表示しないようにします。若干パフォーマンスが上がるかもしれません。
ストレージキャッシュサイズ
  ストレージ（多くの場合はSDカード）のうち何MBまでを動画のキャッシュに使用するか選択します。
ブラウザ ズーム使用
  ブラウザ画面でズームコントロールボタンを表示します。

#### FFmpegライブラリ設定

フィルター使用
  動画の描画にフィルターを使用します。拡大縮小が綺麗に出ますが、重い動画の再生がさらに残念なことになります。
音切れ時にキャッシュ
  音切れが発生したら一時停止しバッファリングを行います。

#### swf再生設定

音声をMediaPlayerで再生
  音声部分の再生にMediaPlayerを使用します。OFFの場合はFFmpegライブラリを使用します。
  MediaPlayer使用の場合は再生開始までに時間がかかり、FFmpegライブラリ使用の場合は音がずれる不具合とシークで落ちる不具合があります。

### プレイヤー部分

MediaPlayer使用、FFmpegライブラリ使用、swfファイル再生かで若干動作が分かれます。

#### 共通事項

横画面モード専用です。
画面の左側のタップ、上下方向へのフリック、メニューキーでコントローラの表示を切り替えます。
画面の右側のタップ、左右方向へのフリックで再生情報の表示を切り替えます。
コントローラを表示中にプレイヤーを終了させるときはバックキーを２回押す必要があります。
コントローラでは、再生の一時停止／再開、シーク、コメント表示の切り替えができます。
コメントの表示のされ方は本物のニコニコ動画プレイヤーと異なります。
コメント表示の一部コマンドには対応していません。

#### MediaPlayer (MP4)

動画の完全なキャッシュが完了してから再生を開始します。
機種によっては一部の動画は再生できません。キャッシュ完了後に判明するので残念な仕様です。
機種によっては一部の動画が途中から正常に再生できなくなります。

#### FFmpegライブラリ (FLV/MP4)

カクカクです。
動画の一部キャッシュができた時点で再生を開始します。でもダウンロードと並行して再生すると特にカクカクです。
MediaPlayerで正常再生できない動画も大抵は再生できます。でもカクカクです。
処理落ちすると自動的にフレームスキップしますがタイミング調整や重すぎる動画の場合の動作などまだ課題があります。カクカクです。

#### swfファイル (SWF)

実験的かつ限定的な実装のため、再生できない動画が大半と思われます。
動画の完全なキャッシュが完了してから再生を開始します。

## 制限事項まとめ

- swf形式の再生が限定的
- コメントの表示が本物のニコニコ動画プレイヤーと異なる
- コメント書き込み非対応
- 投稿者コメント非対応
- ニコスクリプト非対応
- コメントのリスト表示非対応（諸事情により今後一切実装しません）
- 動画のシークが一部遅い
- swf再生で音声をFFmpegライブラリで再生しているときにシークすると落ちます
- ニコ割非対応
- バックグラウンドでの動作非対応
- いろいろ非対応
- 気がついたことがあったらそれは非対応
- FFmpegライブラリによる再生はカクカク
- 機種によってはMediaPlayerで一部の動画の再生ができない
  （高画質、高ビットレートの動画は特に再生が困難です）
- 機種によってはMediaPlayerで一部の動画が途中から正常に再生できなくなる
- FFmpegでフレームレートの低い動画を再生するとコメント描画までフレームレートが低くなる
- ときどき文字化けが起きる（たぶんAndroidの不具合）
- USBケーブル経由でSDカードをマウント中のときはプレイヤーが正常に動作しない
- HVGAだと再生回数等の表示が動画表示領域に食い込む
- 例外が出て落ちたらごめんなさい

## ライセンスについて

NicoRo本体のライセンスは GPL v2.0 です。 ソースコードはSourceForge.JPで公開しています。

本製品はFFmpeg project由来のライブラリを使用しています。 本製品の使用範囲内でのFFmpegのライセンスはLGPL v2.1です。

## 更新履歴

### version 0.0.8

- プレイヤー画面にコントローラ追加（一時停止、シーク、コメント表示切り替え）
- プレイヤー画面の表示情報追加

### version 0.0.7

- コメント非表示機能追加（現状設定画面からのみ切り替え可能）
- 動画ページを表示してから時間が経った後でも正常に再生できるように修正
- サブメニューにブックマーク機能追加
- コメントの１行あたりの表示位置を修正

### version 0.0.6

- サブメニューにストレージのキャッシュクリア機能追加
- オートフレームスキップ機能の調整
- swf形式の再生でのメモリ消費量削減

### version 0.0.5

- FFmpegライブラリによる再生にオートフレームスキップ機能を実装
- FFmpegライブラリ更新
- swf形式ファイルの再生時間が一定量を超えると動画の最後までスキップしてしまう不具合を修正

### version 0.0.4

- swf形式の再生に実験的かつ限定的に対応

### version 0.0.3

- バックグラウンドでのキャッシュダウンロード機能を追加
- 再生ボタンの表示領域を常に表示するように変更（ズームコントロールボタンが再生ボタン等に被さって表示されてしまう問題の回避）

### version 0.0.2

- ログインしていない状態で動画を再生しようとすると強制終了する問題の修正
- 動画のキャッシュ処理中にバックキーで戻ると強制終了することがある問題の修正
- ブラウザ画面にズーム機能を追加
- ニコニコ動画の画面上部メニューを常に固定状態にするようにしてレイアウト崩れの防止
- コメントの衝突判定を修正
- コメントの改行文字に対応（したつもり）
- メニューにもヘルプ表示機能を追加

### version 0.0.1

- 初公開。