
名称	jetson-video-capability
开源协议	‘Apache-2.0’
描述	>- 当需要通过实时SDK API、经过认证的NVIDIA示例和NVIDIA文档来调和Jetson编解码器、配置文件、色度、位深度、尺寸、引擎计数或操作支持问题时使用。也用于涉及Netflix、Widevine或其他DRM保护流媒体服务播放的Jetson问题，以应用编解码器范围边界。 metadata:
作者	‘Vinit Bansal vinitkumarb@nvidia.com’ tags: [jetson, video-codec-sdk, pynvvideocodec, nvenc, nvdec, capability] languages: [python] data-classification: public

Jetson视频能力

目的

在不混淆API响应、成功操作和产品文档的情况下回答Video Codec SDK和PyNvVideoCodec支持问题。先查询实时目标，单独保留精确操作证据，并根据适用的NVIDIA文档发布最终产品支持结论。

前提条件

来自jetson-video-setup的新证据是可选权威，而非先决条件。提供时，对其进行认证并准确使用。缺失时，此技能仅认证所选已安装面：包原生源和请求的报告目标，或确切调用PyNvVideoCodec解释器和wheel。它从不安装、修复、扫描虚拟环境或导入设置代码。
在目标Jetson上使用直接GPU访问进行实时查询。不从不相关的x86主机或另一目标复制可用性。
如果选定面的先决条件缺失，则停止且不更改，并将该面路由到jetson-video-setup；若未安装则告知用户。
保持原生和Python面独立；除非明确选择both，否则仅查询请求的面。
查询执行需要此技能加上有效setup证据或选定的本地先决条件。精确操作检查还要求jetson-video-recipe和jetson-video-pipeline。
对有界操作检查，阅读相关视频内容策略。仅查询工作不需要媒体。当没有setup时，需要用户提供的精确路径/URL及哈希等。

从已安装技能根设置CAPABILITY_SKILL，并用隔离python直接调用拥有的脚本。

组合兄弟阶段

当选定SDK先决条件存在时，无需兄弟。安装/修复用jetson-video-setup；精确操作配方用jetson-video-recipe；吞吐量用jetson-video-benchmark。检查每个阶段前技能目录。缺失时按指定措辞说明并指引安装。

说明

首先分类请求。仅客观质量指标请求说明不提供并停止。仅内容DRM/流媒体服务播放请求，说明只覆盖非DRM硬件编码/解码并停止。未限定’DRM’需先澄清。否则进行能力发现和文档协调。路线说明：显式surface包括native或pynvc；未命名用native优先，不够格再按明文顺序；只有显式auto才自动选择。解析后的surface传递给下游。
应用授权门：仅查询先做，文档明确不支持即最终结论。若实时可用性需要且文档支持或未知，或有明确实验请求，才做最小的匹配官方操作。操作不提升产品支持。无包或凭据更改。
仅认证所选表面：使用匹配setup证据；无效则失败关闭。显式pynvc/both请求在无证据时调用setup probe；缺失用reason。原生用本地查询。缺失用unknown待路由。
运行所选能力路由：阅读相关命令。原生用验证或报告工作区，Py用已验证解释器并带environment。默认编码范围H.264/HEVC/AV1；解码请求可含120元组矩阵。每步保留原始证据，不当作支持结论。
交叉检查NVIDIA文档：阅读文档交叉检查和版本基线URL等。记录URL、检索日期、身份、字段、行。仅用匹配SDK13.0版本注释。
仅在步骤2/5需要时运行最小操作：用recipe解析一个精确配方，由pipeline控制器在独立workspace执行。编码证明需要独立解码器消费输出路径和SHA-256并校验帧数。缺少依赖报告not_tested。
发布调和结果：分别保留caps_query、official_sample_report、operation_evidence、documentation_crosscheck信号。面向客户支持来自文档检查，实时可用性来自成功操作。
完整枚举模糊产品行：一个实时身份对应多个文档候选时，枚举所有候选行并记录数量，不一致保持unknown，不得用API字段缩小身份。

阅读引用文件了解证据语义和表面选择契约。

可用脚本

四个拥有脚本在上述命令下列举。

已发布工件

能力工件可选；已验证的schema-1.2 nvcodec-environment仍可用于下游。

故障排除

保留状态区分；缺失权限按unknown/not_tested处理；操作失败不表示产品不支持；重试最多一次，条件变化后新路径。

局限性

PyNvVideoCodec 2.1 helpers选择GPU0；非零GPU未知。字段不表示吞吐量/质量/延迟。PSNR/SSIM测量在范围外。结果仅适用于产生证据的目标/版本/GPU/操作。