Unity Manual

Language : 中文

Unity 6 User Manual
- Documentation versions
- Offline documentation
- Trademarks and terms of use
What's new in Unity
- New in Unity 6
- New in Unity 6 Preview
- New in Unity 2023.2
- New in Unity 2023.1
Install and upgrade
- Install Unity
- Deploy Unity across your enterprise
  - Enable Unity installation by standard users (Windows)
  - Use Unity through web proxies
- Licenses and activation
- Upgrade Unity
Packages and feature sets
- Unity's Package Manager
- Packages
- Creating custom packages
- Feature sets
Get started with Unity
- 2D or 3D projects
- Quickstart guides
  - 3D game development quickstart guide
    - Creating a 3D game
- Advanced best practice guides
The Unity Editor
- Unity's interface
- Save your work
- Editor Features
- Unity Search
Working in Unity
- Assets and media
- Working with GameObjects
- Working with scenes
- Cameras
- Input
- User interface (UI)
- 2D in Unity
- Troubleshooting
World building
- Sky
- Terrain
- Terrain Tools
Multiplayer
- Use the Multiplayer Center
- New in Multiplayer
Animation
- Mecanim Animation system
- Legacy Animation system
  - Legacy Animation component
Physics
- Built-in 3D Physics
Lighting
- Get started with lighting
  - Introduction to lighting
  - Choose a lighting setup
- Light sources
- Direct and indirect lighting
- Shadows
- Reflections
- Lighting in URP
- Lighting in the Built-In Render Pipeline
- Lighting reference
Materials and shaders
- Textures
- Shaders
- Materials
Visual effects
- Particle systems
- Decals and projectors
- Lens flares
- Light halos
  - Create and configure a halo light effect
  - Halo component reference
- Lines, trails, and billboards
  - Rendering lines
  - Rendering trails
- Visual Effect Graph
Rendering
- Render pipelines
- Post-processing and full-screen effects
- Color
  - Color spaces
  - High dynamic range (HDR)
- Graphics performance and profiling
Audio
- Audio overview
- Audio files
- Tracker Modules
- Audio Mixer
- Native audio plug-in SDK
- Audio playlist randomization
- Audio Profiler module
- Ambisonic Audio
  - Develop an ambisonic audio decoder
- Audio Reference
Video and cutscenes
- Video sources
- Video Player
- Video Profiler module
Scripting
- Get started with scripting
- Environment and tools
- Object-oriented development
- Compilation and code reload
- Code optimization
  - Asynchronous programming
  - Job system
- Debugging and diagnostics
Optimization
- Memory in Unity
  - Managed memory
    - Garbage collector overview
  - Native memory
- Unity Profiler
- Profiling tools
  - Analyzing profiler traces
- Understanding optimization in Unity
- Asset loading metrics
Platform development
- Cross-platform features and considerations
- Android
- Dedicated Server
- iOS
- Linux
- macOS
- tvOS
- Universal Windows Platform
- visionOS
- Web
- Windows
- XR
Unity Services
- Unity IAP
- Unity Distribution Portal
Glossary

Writing shaders in code

Shader object fundamentals

Introduction to writing shaders in code

How you write custom shadersA program that runs on the GPU. More info
See in Glossary in Unity depends on the render pipelineA series of operations that take the contents of a Scene, and displays them on a screen. Unity lets you choose from pre-built render pipelines, or write your own. More info
See in Glossary you use:

For guidance and examples for the Built-in Render Pipeline, see Example shaders for the Built-in Render Pipeline.
For guidance and examples for the the Universal Render Pipeline (URP), see URP: Writing custom shaders.
It is not recommended to write your own shader programs for HDRP, due to the complexity of the code. Instead, use Shader Graph to create Shader objects without writing code.
For an example of a simple vertex and fragment shader for a custom Scriptable Render Pipeline, see Creating a simple render loop in a custom render pipeline.

Languages

When you write shaders for Unity, you use the following languages:

A programming language called HLSL. Use this to write the shader programs themselves. For more information on HLSL, see HLSL in Unity.
A Unity-specific language called ShaderLab. Use this to define a Shader objectAn instance of the Shader class, a Shader object is container for shader programs and GPU instructions, and information that tells Unity how to use them. Use them with materials to determine the appearance of your scene. More info
See in Glossary, which acts as a container for your shader programs. For more information on ShaderLab, see ShaderLabUnity’s language for defining the structure of Shader objects. More info
See in Glossary.

You do not need to use different languages for different platforms; Unity compiles your HLSL and ShaderLab code into different languages for different graphics APIs. For more information, see Shader compilation.

Note: You can also directly write your shader programs in GLSL and Metal if you want. This is not recommended or needed as part of a normal workflow. For more information on using GLSL, see GLSL in Unity.

ShaderLab

ShaderLab is a declarative language that you use in shader source files. It uses a nested-braces syntax to describe a Shader object.

There are many things that you can define in ShaderLab, but the most common are:

Defining the overall structure of the Shader object. See ShaderLab: creating a Shader, ShaderLab: creating a SubShader, and ShaderLab: creating a Pass.
Using code blocks to add shader programs written in HLSL. See ShaderLab: adding shader programs.
Using commands to set the render state of the GPU before it executes a shader program, or to perform an operation involving another Pass. See ShaderLab: commands.
Exposing properties from your shader code so you can edit them in the material InspectorA Unity window that displays information about the currently selected GameObject, asset or project settings, allowing you to inspect and edit the values. More info
See in Glossary and save as part of a material asset. See ShaderLab: defining material properties.
Specifying package requirements for SubShaders and Passes. This enables Unity to run certain SubShaders and Passes only when particular packages are installed in the Unity project. See ShaderLab: specifying package requirements.
Defining fallback behavior for when Unity cannot run any of the SubShaders with a Shader object on the current hardware. See ShaderLab: assigning a fallback.

Different ways of writing shaders

There are different ways of writing shaders:

The most common way is to write vertex and fragment shaders in HLSL. For more information, see Writing vertex and fragment shaders.
In the Built-in Render Pipeline, you can also write Surface Shaders. They are a simplified way of writing shaders that interact with lighting. For more information, see Surface ShadersA streamlined way of writing shaders for the Built-in Render Pipeline. More info
See in Glossary.
For backwards compatibility reasons, Unity also supports “fixed function style” ShaderLab commands. These let you write shaders in ShaderLab, without using HLSL. This is no longer recommended, but it is documented on the page ShaderLab legacy functionality.

Writing shaders for different graphics APIs

In some cases, you must write your shader code differently depending on the graphics API that you are targeting. For information on this, see Writing shaders for different graphics APIs.

Writing shaders in code

Shader object fundamentals