Choose your operating system:
Windows
macOS
Linux
在开发虚幻引擎4（UE4）项目时须注意，UI元素和文本不能过于靠近屏幕边缘，以免这些元素出现扭曲失真。为避免出现类似情况，引擎中加入了电视安全区调试工具。该文档说明如何在 UE4 项目中使用此工具。
什么是电视安全区
电视安全区或安全域是电视生产中用于描述电视画面区域的术语，确保绝大多数电视观众能够清楚地看到播放内容。总而言之，电视节目最重要的内容将被放置在该区域内，确保在各种电视机上播放时不会出现失真。
您可以在维基百科页面中查阅有关电视安全区和安全域的更多内容： 电视安全区 .
标题安全区（Title Safe Zone）和动作安全区（Action Safe Zone）的区别
UE4 有两种不同类型的电视安全区：标题安全区（Title Safe Zone）和动作安全区（Action Safe Zone）。
-
T标题安全区 - 标题安全区可确保UI或文本在查看时不会出现截断或失真。
-
T动作安全区 - 动作安全区可确保角色或敌人移动时身体部分不会出屏。
动作安全区之外的区域在以过扫描显示时可能被裁掉，而动作安全区和标题安全区之间的区域可能被裁掉一部分。部分动作（如其他角色或敌人）发生在该区域中是可以接受的。在许多平台上，动作安全区和标题安全区的尺寸一致。
电视安全区命令
以下部分将介绍电视安全区的命令，以及在虚幻引擎 4（UE4）项目中启用并使用电视安全区调试的两种不同方式。
可在 UE4 控制台中直接输入以下电视安全区命令。
|
命令名 |
数值 |
描述 |
|---|---|---|
|
r.DebugSafeZone.Mode |
0 |
显示所有覆层。 |
|
r.DebugSafeZone.Mode |
1 |
启用标题安全区。 |
|
r.DebugSafeZone.Mode |
2 |
启用动作安全区。 |
|
r.DebugSafeZone.OverlayAlpha |
0 到 1 |
控制调试可视覆层的透明度（默认为 0.3） |
|
r.DebugSafeZone.TitleRatio |
0 到 1 |
控制 FDisplayMetrics 中返回的标题安全区边缘（默认为 0.9）。 |
|
r.DebugActionZone.ActionRatio |
0 到 1 |
控制 FDisplayMetrics 中返回的动作安全区边缘（默认为 0.9）。 |
也可将电视安全区命令放置在项目 [SystemSettings] 部分下的 DefaultEngine.ini 文件中。
启用标题安全区调试预览
为正确显示安全区的比例，您 必须 在 窗口全屏 或 全屏 状态下运行项目。如果不这么做，安全区将无法正确显示，或显示尺寸小于预期。
以下部分将说明如何在调试预览模式下启用安全区。
-
前往 主工具栏 的 Play 部分，点击旁边的白色小箭头变更播放模式选项。
![SZ_Play_Mode.png]()
-
打开 Play Modes 菜单后，选择 New Editor Window (PIE) 选项，让游戏在新的独立窗口中运行。
![SZ_NEW_PIE.png]()
-
按下 Play 按钮在游戏自身的窗口中运行，然后将窗口放大为全屏。
![SZ_Fullscreen_Window.png]()
-
接着，按下波浪符（~）键打开虚幻控制台，输入`r.DebugSafeZone.Mode 1`，然后按下 **Enter** 键应用。
![SZ_Enter_Command.png]()
-
现在，您应该能看到整个播放窗口周边出现了略微透明的红色边界（如下图所示）。
![Safe_Zone_00.png]()
点击查看全图。
调整安全区和动作区的大小
在虚幻控制台中输入以下命令，调整安全区或动作区的大小。
|
命令名 |
数值 |
描述 |
|---|---|---|
|
r.DebugSafeZone.TitleRatio |
范围 0 到 1 |
控制 FDisplayMetrics 中返回的安全区边缘（默认为 0.9）。 |
|
r.DebugActionZone.ActionRatio |
范围 0 到 1 |
控制 FDisplayMetrics 中返回的动作区边缘（默认为 0.9）。 |
无法同时启用安全区和动作区。如要查看另一个区，必须先禁用当前正在查看的区，然后再启用需要查看的区。
下图中，命令 r.DebugActionZone.ActionRatio 将动作区的大小从 0.99 缩小到 0.1。
拖动滑条可显示调整安全区大小的效果。
调整安全区和动作区覆层的透明度
在虚幻控制台中输入以下命令，增加/减少安全区和动作区的不透明度。
|
命令名 |
数值 |
描述 |
|---|---|---|
|
r.DebugSafeZone.OverlayAlpha |
0 到 1 |
控制安全区和动作区覆层的不透明度（默认为 0.3）。 |
在下图中可了解到 r.DebugSafeZone.OverlayAlpha 数值从 1.0 设为 0.1 后安全区和动作区覆层不透明度的变化。
拖动滑条可显示调整 Alpha 覆层不透明度的效果。
电视安全区疑难排解
以下部分介绍需要注意的一些信息，确保正确使用电视安全区。
-
现在安全区根据全屏尺寸进行定义（API 并非针对非主机平台设计），不会直接返回比例在窗口模式中使用。此项在未来的版本中可能会进行修改，但当下需要在 窗口全屏 或 全屏 下运行才能获得正确比例。
-
当前 UI 还无法在运行时处理此修改，因此在运行中通过控制台变更标题比例/动作比例时需要切换游戏模式方可显示变化（如：从前端到游戏中，或相反，或再次"open FrontEndScene"）。
-
在 PS4 上使用此工具时只需要第一个命令 r.DebugSafeZone.Mode 1 ，因为可在 PS4 操作系统菜单中选择系统设置决定安全区数值。