jetson-video-capability

Jetson Video Capability

次の3つの根拠を混同しないでください。

• API クエリ：生のフィールドであり、操作や製品サポートの証拠ではありません。
• 認証済みの NVIDIA サンプル：レポート、または正確な操作の証拠です。
• 適用可能な NVIDIA ドキュメント：製品サポートの判定根拠です。

スコープの判定

• PSNR、SSIM、その他の客観的な品質指標のみを求めるリクエストの場合、このスキルでは対応しておらず、別途認可された品質ワークフローが必要であると伝えてください。それ以外の作業は行わないでください。
• Netflix、Widevine、PlayReady、または明らかにコンテンツ保護されたストリーミングについては、このスキルが対象とするのは、ユーザー提供の非 DRM ビットストリームのハードウェアエンコード／デコードであり、コンテンツ DRM の再生ではないことだけを伝えてください。サービスが動作するかどうかの断定、Jetson の認証、CDM、セキュア再生の要件についての説明、ブラウザーや DRM モジュール、回避策、バイパスの推奨は行わず、そこで終了してください。限定のない「DRM」は Linux DRM/KMS を意味する場合があります。文脈から意味を特定できない場合は、どちらの意味か尋ねてください。
• 単に「video SDK」とだけ指定されている場合は、調査を開始する前に、ネイティブの Video Codec SDK、PyNvVideoCodec、または両方のどれを指すのか尋ねてください。それ以外で限定のない機能リクエストには、surface-selection-contract.md にあるネイティブ優先のフォールバックを適用してください。

読み取り専用の調査

機能の確認には、最新の読み取り専用インストールチェックを行う jetson-video-setup が必要です。公開ディスパッチを通じてこのスキルを呼び出し、報告された正確なネイティブパッケージ／Samples ルート、または正確な PyNvVideoCodec のインタープリター、バージョン、ロード済みモジュールパスを使用してください。setup のファイルを探したり、インポートしたりしないでください。サーフェスが存在しない、または一致しない場合は unknown／not_ready とし、コーデック非対応とは判定せず、ここで何も変更せずに修復を setup に引き継いでください。

エンジン機能のクエリは setup ではなく、このスキルの担当です。PyNvVideoCodec については、選択した正確なインタープリターを使い、capability-queries.md の説明に従って、公開 API の GetEncoderCaps と GetDecoderCaps を呼び出してください。エンコーダーの全般カタログは H.264、HEVC、AV1 を対象とし、デコーダーの全般カタログは、4 種類のクロマ形式と 3 種類のビット深度を組み合わせた 10 ファミリーすべて（正確なタプルが 120 件）を対象とします。範囲を限定したリクエストでは、該当するカタログ集合のうち、指定された項目のみをクエリしてください。対象範囲内のすべてのレコード、エラー、GPU ordinal を保持してください。公開ヘルパーが GPU 0 のみを選択する場合、GPU 0 以外のヘルパー結果は引き続き unknown としてください。

ネイティブレポートについては、認証済みのパッケージ同梱バイナリを再利用するか、新しいユーザー所有ツリーで必要なレポートターゲットのみをビルドしてから、capability reference のビルド、ID、文法の各ルールに従って AppEncCuda -ec および／または AppDec -dc を実行してください。クエリのみのリクエストでは、パッケージのインストールも、エンコード／デコード操作も認可されません。パッケージ、ソース、ツール、インタープリター、またはランタイムライブラリの ID を確認できない場合は、結果を unknown として報告し、不足している setup の前提条件を明記してください。

意思決定の流れ

1. プローブを実行する前に、対象範囲と選択するサーフェスを分類します。
2. 選択したサーフェスのみを照会します。生のレコード、エラー、正確な GPU、リリース、インタープリター／バイナリの識別情報、argv、およびエビデンスの分類を保持します。
3. デバイスツリーのパスと NUL の処理については、 capability-queries.md に従って、稼働中の製品を最も正確に特定し、NVIDIA の最新の Video Encode and Decode Support Matrix およびリリースに対応する SDK 13.0 の NVENC または NVDEC アプリケーションノートと照合します。記憶、エンジン数、機能フィールド、または操作の挙動から SKU を推測してはなりません。参照資料の手動記録を使用して、ソース URL、取得日、表のタイトル、行／列の正確なラベル、およびセルの値を保持します。 一般的なファミリーの識別情報は正確なものとして扱いません。認証済みのすべての候補が一致する場合に限り、候補行のコンセンサスを使用します。
4. API または診断操作が肯定的な結果であっても、ドキュメントの No は最終的な非対応製品の判定として報告します。これにより、通常の利用可否確認は終了します。ドキュメントの Yes は文書化されたサポートを示します。実際に利用可能であることを確認するには、対応する認証済み操作も必要です。ドキュメントが欠落している、取得できない、または内容が矛盾している場合は、不明のままです。ドキュメントが不明な場合、肯定的な機能フィールドを利用可能なオプションとして提示してはなりません。影響を受ける各コーデックの横に unknown と表示し、判定とともに取得失敗の理由を記載します。
5. PyNvVideoCodec のエンコード利用可否操作では、セットアップに full-samples プロファイルを要求し、その正確なインタープリターをレシピとパイプラインの各段階で引き継ぎます。より小規模な decode-performance／smoke プロファイルは選択しません。
6. ライブの利用可否確認をユーザーが要求し、ドキュメントが肯定的または不明である場合、あるいは否定的な判定にもかかわらず診断を明示的に要求した場合に限り、正確な操作を実行します。ドキュメントが No の場合の診断では、その正確なタプルについて operation_verified または operation_failed のみを報告し、非対応製品という判定は変更しません。タプルとは、テスト対象のサーフェス、GPU、コーデック、プロファイル、クロマ、ビット深度、寸法、入力形式、および制御セットの正確な組み合わせです。jetson-video-recipe でレシピを 1 つ解決し、次に jetson-video-pipeline を使用してエンコードを行い、その後、正確な出力の識別情報を使って個別にデコードします。タプルでの失敗を製品全体に一般化してはなりません。

証拠に関するルール

• GetEncoderCaps の成功は capability_reported、supported=null、 operation_status=not_tested です。
• GetDecoderCaps の bIsSupported=1/0 は、生の API の true/false と、返された制限が適用されるかどうかを記録します。どちらの値もドキュメント上の判定ではありません。
• 列挙値、呼び出し、フィールド、前提条件、または 0 以外の GPU に関する根拠がない場合は、「非対応」ではなく「不明」です。
• ネイティブの -ec/-dc テキストは official_sample_report です。生の値を保持し、API または製品に関する主張として書き換えないでください。
• Main10 のサポートを報告する場合、NVENC は検証済みの 8 ビット入力を内部で変換できること、および P010 が入力ビット深度変換を行わない正確な経路であることを明記してください。実環境でのサポートを主張するには、認証済みの 10 ビット操作が引き続き必要です。
• AV1 の出力が操作の証拠となるのは、パイプラインに付属するデコーダーが正確な成果物を読み込み、期待されるフレーム数を報告した場合に限ります。
• VP9 のエンコードに関する質問には、VP9 は引き続きデコーダーファミリーであり、リリース済みの NVENC 経路は存在しないことだけを報告してください。他のエンコーダーの一般的な一覧を追加したり、診断用のエンコード操作を提案したりしないでください。
• プリセット、チューニング、パッケージの存在、スループット、および並行ストリームの成功は、コーデックのサポートや NVENC/NVDEC エンジン数の根拠にはなりません。
• コーデック/API の機能、NVENC/NVDEC の利用可否、および上限付き操作の成功は、DMA-BUF、NvSciBuf、CUDA メモリー共有、ゼロコピー、またはステージ間の同期互換性の根拠にはなりません。

Python API に関する問い合わせでは、この Markdown とインストール済みの公開 SDK をもとに、そのタスク専用の短いプログラムを作成し、選択した正確なインタープリターで実行して、生の出力を結果とともに保持してください。インストールはセットアップに属し、操作の検証はパイプラインに属します。このスキルが担当するのは、エンジンへの問い合わせ、分類、ドキュメントとの照合、および上記の簡潔な直接報告です。