文档

Unity command-line interface (CLI)

Download Unity Hub

Unity command-line interface (CLI)

Unity CLI telemetry data

Review the data that the Unity command-line interface (CLI) sends to Unity and the project information that stays on your machine.
阅读时间2 分钟最后更新于 12 小时前

注意
This page applies to Unity CLI 1.0.0-beta.17 and later.
The Unity CLI sends three types of telemetry: an anonymous usage count, usage analytics, and crash reports. This page describes what each type contains and which project information never leaves your machine. To disable any of these data types, refer to Disable Unity CLI data collection.

Data types

The following table lists when the CLI sends each data type and what each data type includes. Each data type is separate, and you can disable each one independently.

Data type

Default setting

When data is sent

Data included

Data not included

Anonymous usage countOnOnce each time the CLI runsThe Unity tool that sent the event, the CLI version, the project's Unity version, and whether the CLI ran from a terminal, a continuous integration (CI) system, or an AI agentAccount, user, machine, or session identifiers; file paths; command arguments
Usage analyticsOnWhile the CLI runsCommand names (not their arguments or option values), outcomes and error codes, Unity and Editor versions, and an opaque project ID. If you're signed in, the CLI links this data to your Unity ID.Project names, file paths, project contents, tokens, or credentials
Crash reportsOnOnly when the CLI itself crashesTechnical details about the crashPersonal or project data. Before the CLI sends a report, it removes home directory paths, user account names, tokens, passwords, and URLs.

First-run notice

The first time you run the CLI interactively, it displays the following one-time notice:
Unity CLI sends usage analytics and crash reports to help us improve it. To turn this off or learn more: https://docs.unity.com/en-us/unity-cli/data-collection-privacy-controls

Project information sent to Unity

The following table lists which project information the CLI sends to Unity. When you disable usage analytics, no information that identifies your project leaves your machine.

Information

Sent to Unity

Project nameNo
File or folder pathsNo
Project contents (scenes, assets, code)No
Build target platformNo
Project's Unity versionYes, in the anonymous usage count and in usage analytics
Project IDOnly while usage analytics is on, as an opaque ID
If
unity build
writes a build manifest, the manifest stays on your local disk. The CLI removes machine paths and credentials from the manifest.

Additional resources