コーデックとメディアの検査

上級者

古いコーデックやサイズが大きくなるコーデックの映画を探し、より良い品質のファイルを検索します。

コーデックとは、H.264 や AV1 のような動画の圧縮方式です。新しいコーデックほど、同じ画質をより小さなファイルで実現できます。ライブラリを管理する権限が必要です。

コーデックでファイルを探す

一覧には、存在する映画の本編ファイルが、バージョンとあわせて 1 ページ 50 行ずつ表示されます。ページを移動しても、入れたチェックは残ります。

HolyArrs は、各バージョンを現在の選定ルールで検索します。何かを選んだり、取得したり、置き換えたり、削除したりはせず、ルールも変更しません。より良いリリースが存在しないこともあります。

HolyArrs は、映画や番組をインポートするとき、ディスク上にすでにあるファイルを管理対象にするとき、再スキャンするときに、ファイルの中でトラックの一覧を記録している部分を読み取ります。リリース名は一切考慮しません。読み取れなかったものは Unknown(不明)と表示されます。

読み取るもの	記録するもの
Matroska(`.mkv`)、WebM、MP4 または QuickTime(`.mp4`、`.mov`)	Container(コンテナ)
H.264、HEVC、AV1、VP9、MPEG-2、Xvid、VC-1 のいずれか	Video codec(動画コーデック)
各音声の言語。基本コードに切り詰めます(`en-US` は `en` として数えます)	Audio languages(音声言語)
音声トラックの数	Audio tracks(音声トラック)
言語がない、`und` である、または値が正しくないトラック	Unknown audio(不明な音声)
どこまで読み取れたか	Status(ステータス): complete、partial、unsupported のいずれか

音声言語は、ファイルがバージョンの条件を満たすかどうかの判定にも使われます。オリジナル音声と吹き替え音声を参照してください。

検査ではファイルを再生もデコードもしないため、すべてのフレームが正常であることまでは確かめられません。ネットワークは使わず、ほかのプログラムも実行しません。音楽ファイルは検査されません。

症状: ファイルにチェックを入れられません。 原因: 保護されています。保護したファイルを参照してください。

症状: コーデックが Unknown と表示されます。 原因: 対応していないコンテナ、一覧にないコーデック、または読み取れないファイルです。

症状: ファイルが破損していると報告されます。 原因: トラックの情報が途中で切れているか、つじつまが合っていません。 対処: ファイルを新しく入手し直します。

症状: Review がファイルを受け付けません。 原因: ファイルが移動された、「なし」になっている、映画の本編ファイルではない、そのバージョンから外れた、または保護されています。

症状: 検索が古くなっていると表示されます。 原因: 確認したあとに何かが変わりました。 対処: もう一度 Review を選択します。

API

これらのルートには、ライブラリを管理する権限が必要です。

ルート	内容
`GET /api/v1/library/copies?q=&codec=&sort=&limit=&offset=`	ファイルを一覧表示します
`POST /api/v1/library/copies/search/preview`	選択内容を確認し、`review_token` を返します
`POST /api/v1/library/copies/search`	検索を実行します

プレビューのボディ:

{"selections":[{"file_id":12,"version_id":7}]}

同じ選択内容に review_token を加えて、検索のルートに送ります。確認のあとに変更があった場合は 409 Conflict が返ります。