版本: Unity 6 (6000.0)
语言英语
  • C#

ScreenCapture.CaptureScreenshot

建议更改

成功!

感谢您帮助我们提高 Unity 文档的质量。虽然我们无法接受所有提交内容,但我们确实会阅读来自用户的每项建议更改,并在适用的情况下进行更新。

关闭

提交失败

由于某些原因,您的建议更改无法提交。请<a>稍后再试</a>。感谢您抽出时间帮助我们提高 Unity 文档的质量。

关闭

取消

声明

public static void CaptureScreenshot(string filename, int superSize);

声明

public static void CaptureScreenshot(string filename, ScreenCapture.StereoScreenCaptureMode stereoCaptureMode);

参数

filename 保存截图文件的路径。
superSize 用于增加分辨率的系数。
stereoCaptureMode 启用立体渲染时要捕获的眼睛纹理。

描述

捕获屏幕截图并将其保存为 .png 文件到指定的路径。

如果截图已存在,ScreenCapture.CaptureScreenshot 将用新的截图覆盖它。

filename 的末尾添加 .png 以将截图保存为 .png 文件。

在移动平台上,filename 会附加到持久数据路径。有关持久数据路径的更多信息,请参阅 Application.persistentDataPath

在非移动平台上,filename 是相对于可执行文件目录的文件路径。在编辑器中,filename 是相对于项目目录的文件路径。

superSize 参数大于 1 时,会生成更高分辨率的截图。例如,如果您传递 4,您将创建一个比正常情况下大 4x4 倍的截图。这对于生成要打印的截图很有用。

using UnityEngine;

// Generate a screenshot and save it to disk with the name SomeLevel.png.

public class ExampleScript : MonoBehaviour { void OnMouseDown() { ScreenCapture.CaptureScreenshot("SomeLevel.png"); } }

CaptureScreenshot 在 Android 上立即返回。屏幕截图将在后台继续进行。生成的截图将在几秒钟后保存到文件系统中。