RAW写真のサムネイルがウェブでは表示されるのに、モバイルでは表示されないのはなぜ?

Eva Wong は テクニカルライター であり、 生粋の技術好き としてZimaSpaceで活動しています。ホームラボやオープンソースソフトウェア をこよなく愛する生粋のギークで、複雑な技術概念をわかりやすく、実践的なガイド にまとめることを得意としています。Evaは、セルフホスティングは難しいものではなく、楽しむものだと考えています。チュートリアルを通じて、初めてのNAS構築からDockerコンテナの使いこなしまで、コミュニティがハードウェアのセットアップをわかりやすく理解できるよう 支援しています。、初めてのNAS構築からDockerコンテナの習得まで。

RAWのサムネイルがブラウザーでは表示できてもモバイルでは表示できない場合があります。2つのクライアントが異なるプレビュー、派生画像、サイズ、デコード経路を要求している可能性があるためです。

まず、同じライブラリにある正常に動作するRAWファイルと問題が起きるRAWファイルを1つずつ用意します。ウェブとモバイルから送信されるサムネイルリクエストを正確に比較し、カメラ内で生成されたプレビュー、サーバーでレンダリングされた派生画像、モバイルのローカルキャッシュを切り分けます。元のRAWファイルに問題はなく、表示経路の1つだけが壊れている可能性があります。

モバイルが別のプレビューを要求しているか確認する

アプリケーションログまたはリクエスト経路を記録しながら、同じRAWファイルをウェブインターフェースとモバイルアプリで開いてください。要求されたサムネイルのサイズと拡張子、レスポンスコード、モバイルクライアントが元のファイルにフォールバックするかどうかを比較します。

多くのRAWファイルには埋め込みJPEGプレビューが含まれています。ウェブクライアントはその埋め込み画像を表示し、別のクライアントはサーバーが個別に生成した派生画像を要求することがあります。

2つのクライアントが異なるオブジェクトを要求している場合、その症状をあらゆるRAWデコードに共通する問題として扱うのはやめてください。次は、モバイルだけが使用する派生画像またはクライアントの経路をテストします。

埋め込みプレビューとサーバーのレンダリングを比較する

RAWファイルに埋め込まれたプレビューを抽出または確認し、サーバーで生成したサムネイルと比較します。埋め込みJPEGは正常で、生成されたサムネイルだけが失敗する場合は、異なるコード経路に問題があります。

写真管理ツールのドキュメントでは、埋め込みJPEGプレビューとレンダリングされたRAWデータのRAWのレンダリング動作が区別されています。そのため、一方のサムネイル経路で表示できても、もう一方の動作が正常とは限りません。

生成されたサムネイルだけに問題がある場合は、サーバーのデコーダーと派生画像の生成ジョブを調べてください。埋め込みプレビューだけに問題がある場合は、サーバーを変更する前に、同じカメラで撮影した別のファイルを試してください。

拡張子だけでなくRAWの形式を確認する

カメラのモデル、ファームウェア、RAW圧縮モード、ビット深度、問題が起きるファイルがネイティブRAW、DNG、スマートフォン固有のRAW形式のどれなのかを記録してください。正常に動作するサンプルと比較します。

DNGでもプレビューと画像の構造が異なる場合があるため、拡張子が同じファイルならすべて同じデコード経路でクライアントに届くと思い込まず、DNGプレビューの差異を確認することが大切です。

特定のカメラでのみ発生する差は、有用な手がかりです。その形式を処理できないデコーダーコンポーネントだけを更新または置き換えるか、元のRAWファイルを保持したまま、互換性のある派生ファイルを生成してください。

壊れているモバイルのキャッシュレイヤーだけを消去する

サーバーログでサムネイルの生成が成功している場合は、キャッシュを無効にしてモバイル用アセットをテストするか、対象を絞ってアプリのキャッシュを消去した後、または別の端末でテストしてください。最初からサーバーのサムネイルをすべて削除しないでください。

ProRAWの処理経路のようなスマートフォンのRAW処理では、表示前に別の処理レイヤーが加わります。そのため、同じ元ファイルでも、クライアントのデコーダーやキャッシュされた派生ファイルの挙動がデスクトップブラウザーとは異なる場合があります。

別のモバイル端末で動作する場合は、端末内のキャッシュまたはアプリのバージョンに注目してください。すべてのモバイル端末で同じ派生ファイルのURLが表示されない場合は、クライアントを何度も再インストールするのではなく、サーバーの応答を調べてください。

派生ファイルを1つだけ再生成して再テストする

アプリケーションのサポートする手順に従って、問題がある派生ファイルだけを、対象を限定してRAWファイル1つ分削除または無効化し、サーバーに再生成させてください。新しいオブジェクトのサイズと応答を記録します。

Immich家族写真ライブラリに関するZimaSpaceの関連ガイドでは、元のファイルを保護し、派生ファイルの再生成をいつでもやり直せるようにするという関連する方針を説明しています。プレビューの問題が写真の消失につながらないようにしましょう。

キャッシュの有効期限が切れた後、アプリを再起動し、サーバーに新しくリクエストしたうえで、同じRAWファイルがウェブとモバイルの両方に表示された場合にのみ、問題が解決したと判断してください。派生ファイルを再生成しても問題が続く場合は、デコーダーのレベルで比較できるよう、そのファイルを保管してください。

よくある質問

ブラウザーではサムネイルが表示されるのに、モバイルアプリでは何も表示されないのはなぜですか?

2つのクライアントでは、要求する派生ファイル、サイズ、形式、またはキャッシュ項目が異なる場合があります。そのため、ブラウザーでプレビューが正常に表示されても、モバイル用のプレビューオブジェクトに問題がないとは限りません。

モバイルで表示するためだけにRAWファイルをJPEGに変換するべきですか?

最初の対処としては適切ではありません。元のアーカイブを複製したり変換したりする前に、埋め込みプレビューまたは生成された派生ファイルのどちらに問題があるかを確認してください。

あるカメラのモデルでは問題が発生し、別のモデルでは発生しないことがありますか?

はい。RAW形式と埋め込みプレビューの選択肢はカメラのモデルやファームウェアによって異なるため、すべてのRAWファイルを同じものとして扱わず、正常に表示されるファイルと表示されないファイルを1つずつ比較してください。

サポートとヒント

続きを読む

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.