将着色器设置为需要图形 API 或平台

一些#pragma指令采用允许您定位特定图形 API 和平台的参数。此页面包含有关使用这些指令的信息，并提供有效参数值的列表。

包括或排除图形 API

默认情况下，Unity 会编译所有着色器在 GPU 上运行的程序。更多信息
请参阅术语表当前生成目标列表中每个图形 API 的程序。有时，您可能只想为某些图形 API 编译某些着色器程序;例如，如果您使用并非所有平台都支持的功能。

要仅为给定的 API 编译着色器程序，请使用#pragma only_renderers命令。您可以传递多个值，以空格分隔。

此示例演示了如何仅为 Metal 和 Vulkan 编译着色器：

#pragma only_renderers metal vulkan

若要从给定编译器的编译中排除着色器代码，请使用#pragma exclude_renderers命令。您可以传递多个值，以空格分隔。

此示例演示了如何从 Metal 和 Vulkan 的编译中排除着色器：

#pragma exclude_renderers metal vulkan

为给定图形 API 的图形层生成着色器变体

在内置渲染管线（Render Pipeline） 获取场景内容并将其显示在屏幕上的一系列作。Unity 允许您从预构建的渲染管道中进行选择，或编写自己的渲染管道。更多信息
请参阅术语表，Unity 自动生成着色器变体Unity 根据着色器关键字及其状态的特定组合生成的着色器程序的版本。一个着色器对象可以包含多个着色器变体。更多信息
请参阅术语表在特定条件下对应于图形层。如果需要，您还可以强制 Unity 生成这些变体。

为此，请使用#pragma hardware_tier_variantspreprocessor 指令，并指定要为其生成层着色器变体的图形 API。

例如，这指示 Unity 编译 Metal 的层着色器变体：

#pragma hardware_tier_variants metal

有效参数值列表

支持的值包括：

其他资源

• HLSL 编译指示参考
• HLSL 编译指示目标命令参考
• HLSL 编译指示需要命令引用
• ShaderLab 中的子着色器标记参考
• 在 ShaderLab 参考中传递标签