# 添加设备 > Explains how to define a new device to simulate and use it in the Device Simulator. 要将新设备添加到设备模拟器，请创建一个设备定义和设备覆盖层。 设备定义是 Unity 项目中扩展名为 `.device` 的文本文件。它包含描述设备属性的 JSON。 设备覆盖层是指包含设备屏幕边框的图像，此外还包括缺口、开孔以及屏幕矩形区域外的其他任何附加部分。可以选择将其与设备定义一起使用，以可视化呈现硬件元素如何遮挡设备屏幕，并确定触控输入何时因此失效。 ## 创建设备定义 设备定义是表示设备的 JSON 文件。它具有必要属性和一些可选属性。如果设备定义文件包含任何错误，则在选择文件时，错误将显示在检视器中。 ### 框架 | **属性** | **必需** | **描述** | | ---------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------- | | **friendlyName** | 是 | 要在此设备的 UI 中显示的名称。 | | **version** | 是 | 指示设备定义文件的版本。目前，版本为 `1`。 | | **screens** | 是 | 对象列表，其中每个对象都描述了要模拟设备的屏幕。必须包含至少一个屏幕。有关每个屏幕对象的框架的信息，请参阅[屏幕](#screen)。 | | **systemInfo** | 是 | 描述设备功能的对象。此对象中的值映射到 [SystemInfo](/engine/6000.0/script-reference/unity-engine/system-info.md)。有关 systemInfo 对象框架的信息，请参阅 [systemInfo](#systeminfo)。 | #### 屏幕 | **属性** | **必需** | **描述** | | ----------------------- | ------ | -------------------------------------------------------------------------------------- | | **width** | 是 | 屏幕的宽度（以像素为单位）。 | | **height** | 是 | 屏幕的高度（以像素为单位）。 | | **navigationBarHeight** | 否 | 屏幕 Android 导航栏的高度（以像素为单位），在某些设备上非全屏显示时会出现此导航栏。 | | **dpi** | 是 | 屏幕的 dpi。 | | **orientations** | 否 | 对象列表，其中每个对象都描述了屏幕可以模拟的方向。如果没有为此属性设置值，则屏幕支持模拟所有方向。有关每个方向对象的框架的信息，请参阅[方向](#orientation)。 | | **presentation** | 否 | 描述设备覆盖层的对象。有关此对象的框架的信息，请参阅[演示](#presentation)。 | #### 方向 | **属性** | **必需** | **描述** | | --------------- | ------ | --------------------------------------------------------------------------------------------------------------- | | **orientation** | 是 | 屏幕方向。此属性的值是一个映射到 [ScreenOrientation](/engine/6000.0/script-reference/unity-engine/screen-orientation.md) 枚举的数字。 | | **safeArea** | 否 | 确定屏幕安全区域的[矩形](/engine/6000.0/script-reference/unity-engine/rect.md)。如果没有为此属性设置值，模拟器会默认整个屏幕都是安全的。 | | **Cutout** | 否 | [Rect](/engine/6000.0/script-reference/unity-engine/rect.md) 列表，指定了屏幕中无法显示内容的区域。 | #### 演示 | **属性** | **必需** | **描述** | | --------------- | ------ | ------------------------- | | **overlayPath** | 否 | 从设备定义文件到要用作设备覆盖层的图像的相对路径。 | | **borderSize** | 否 | 从覆盖层到屏幕开始位置的距离（以像素为单位）。 | #### systeminfo 此对象中的属性描述了设备的功能和系统信息。由于它们描述了系统信息，因此许多都映射到 [SystemInfo](/engine/6000.0/script-reference/unity-engine-device/system-info.md) 中的属性。 | **属性** | **必需** | **描述** | | --------------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------- | | **deviceModel** | 否 | 请参阅 [Device.SystemInfo.deviceModel](/engine/6000.0/script-reference/unity-engine-device/system-info/device-model.md)。 | | **deviceType** | 否 | 请参阅 [Device.SystemInfo.deviceType](/engine/6000.0/script-reference/unity-engine-device/system-info/device-type.md)。 | | **operatingSystem** | 是 | 请参阅 [Device.SystemInfo.operatingSystem](/engine/6000.0/script-reference/unity-engine-device/system-info/operating-system.md)。 | | **operatingSystemFamily** | 否 | 请参阅 [Device.SystemInfo.operatingSystemFamily](/engine/6000.0/script-reference/unity-engine-device/system-info/operating-system-family.md)。 | | **processorCount** | 否 | 请参阅 [Device.SystemInfo.processorCount](/engine/6000.0/script-reference/unity-engine-device/system-info/processor-count.md)。 | | **processorFrequency** | 否 | 请参阅 [Device.SystemInfo.processorFrequency](/engine/6000.0/script-reference/unity-engine-device/system-info/processor-frequency.md)。 | | **processorType** | 否 | 请参阅 [Device.SystemInfo.processorType](/engine/6000.0/script-reference/unity-engine-device/system-info/processor-type.md)。 | | **supportsAccelerometer** | 否 | 请参阅 [Device.SystemInfo.supportsAccelerometer](/engine/6000.0/script-reference/unity-engine-device/system-info/supports-accelerometer.md)。 | | **supportsAudio** | 否 | SystemInfo.supportsAudio | | **supportsGyroscope** | 否 | 请参阅 [Device.SystemInfo.supportsGyroscope](/engine/6000.0/script-reference/unity-engine-device/system-info/supports-gyroscope.md)。 | | **supportsLocationService** | 否 | 请参阅 [Device.SystemInfo.supportsLocationService](/engine/6000.0/script-reference/unity-engine-device/system-info/supports-location-service.md)。 | | **supportsVibration** | 否 | 请参阅 [Device.SystemInfo.supportsVibration](/engine/6000.0/script-reference/unity-engine-device/system-info/supports-vibration.md)。 | | **systemMemorySize** | 否 | 请参阅 [Device.SystemInfo.systemMemorySize](/engine/6000.0/script-reference/unity-engine-device/system-info/system-memory-size.md)。 | | **unsupportedIdentifier** | 否 | 请参阅 [Device.SystemInfo.unsupportedIdentifier](/engine/6000.0/script-reference/unity-engine-device/system-info/unsupported-identifier.md)。 | | **graphicsDependentData** | 否 | 对象列表，其中每个对象都描述了设备支持的图形 API。有关每个对象的框架的信息，请参阅 [graphicsDependentData](#graphicsdependentdata)。 | #### graphicsDependentData 对象中的属性描述了设备支持的图形 API。 | **属性** | **必需** | **描述** | | --------------------------------------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **graphicsDeviceType** | 是 | 请参阅 [Device.SystemInfo.graphicsDeviceType](/engine/6000.0/script-reference/unity-engine-device/system-info/graphics-device-type.md)。 | | **graphicsMemorySize** | 否 | 请参阅 [Device.SystemInfo.graphicsMemorySize](/engine/6000.0/script-reference/unity-engine-device/system-info/graphics-memory-size.md)。 | | **graphicsDeviceName** | 否 | 请参阅 [Device.SystemInfo.graphicsDeviceName](/engine/6000.0/script-reference/unity-engine-device/system-info/graphics-device-name.md)。 | | **graphicsDeviceVendor** | 否 | 请参阅 [Device.SystemInfo.graphicsDeviceVendor](/engine/6000.0/script-reference/unity-engine-device/system-info/graphics-device-vendor.md)。 | | **graphicsDeviceID** | 否 | 请参阅 [Device.SystemInfo.graphicsDeviceID](/engine/6000.0/script-reference/unity-engine-device/system-info/graphics-device-id.md)。 | | **graphicsDeviceVendorID** | 否 | 请参阅 [Device.SystemInfo.graphicsDeviceVendorID](/engine/6000.0/script-reference/unity-engine-device/system-info/graphics-device-vendor-id.md)。 | | **graphicsUVStartsAtTop** | 否 | 请参阅 [Device.SystemInfo.graphicsUVStartsAtTop](/engine/6000.0/script-reference/unity-engine-device/system-info/graphics-uv-starts-at-top.md)。 | | **graphicsDeviceVersion** | 否 | 请参阅 [Device.SystemInfo.graphicsDeviceVersion](/engine/6000.0/script-reference/unity-engine-device/system-info/graphics-device-version.md)。 | | **graphicsShaderLevel** | 否 | 请参阅 [Device.SystemInfo.graphicsShaderLevel](/engine/6000.0/script-reference/unity-engine-device/system-info/graphics-shader-level.md)。 | | **graphicsMultiThreaded** | 否 | 请参阅 [Device.SystemInfo.graphicsMultiThreaded](/engine/6000.0/script-reference/unity-engine-device/system-info/graphics-multi-threaded.md)。 | | **renderingThreadingMode** | 否 | 请参阅 [Device.SystemInfo.renderingThreadingMode](/engine/6000.0/script-reference/unity-engine-device/system-info/rendering-threading-mode.md)。 | | **hasHiddenSurfaceRemovalOnGPU** | 否 | 请参阅 [Device.SystemInfo.hasHiddenSurfaceRemovalOnGPU](/engine/6000.0/script-reference/unity-engine-device/system-info/has-hidden-surface-removal-on-gpu.md)。 | | **hasDynamicUniformArrayIndexingInFragmentShaders** | 否 | 请参阅 [Device.SystemInfo.hasDynamicUniformArrayIndexingInFragmentShaders](/engine/6000.0/script-reference/unity-engine-device/system-info/has-dynamic-uniform-array-indexing-in-fragment-shaders.md)。 | | **supportsShadows** | 否 | 请参阅 [Device.SystemInfo.supportsShadows](/engine/6000.0/script-reference/unity-engine-device/system-info/supports-shadows.md)。 | | **supportsRawShadowDepthSampling** | 否 | 请参阅 [Device.SystemInfo.supportsRawShadowDepthSampling](/engine/6000.0/script-reference/unity-engine-device/system-info/supports-raw-shadow-depth-sampling.md)。 | | **supportsMotionVectors** | 否 | 请参阅 [Device.SystemInfo.supportsMotionVectors](/engine/6000.0/script-reference/unity-engine-device/system-info/supports-motion-vectors.md)。 | | **supports3DTextures** | 否 | 请参阅 [Device.SystemInfo.supports3DTextures](/engine/6000.0/script-reference/unity-engine-device/system-info/supports-3-d-textures.md)。 | | **supports2DArrayTextures** | 否 | 请参阅 [Device.SystemInfo.supports2DArrayTextures](/engine/6000.0/script-reference/unity-engine-device/system-info/supports-2-d-array-textures.md)。 | | **supports3DRenderTextures** | 否 | 请参阅 [Device.SystemInfo.supports3DRenderTextures](/engine/6000.0/script-reference/unity-engine-device/system-info/supports-3-d-render-textures.md)。 | | **supportsCubemapArrayTextures** | 否 | 请参阅 [Device.SystemInfo.supportsCubemapArrayTextures](/engine/6000.0/script-reference/unity-engine-device/system-info/supports-cubemap-array-textures.md)。 | | **copyTextureSupport** | 否 | 请参阅 [Device.SystemInfo.copyTextureSupport](/engine/6000.0/script-reference/unity-engine-device/system-info/copy-texture-support.md)。 | | **supportsComputeShaders** | 否 | 请参阅 [Device.SystemInfo.supportsComputeShaders](/engine/6000.0/script-reference/unity-engine-device/system-info/supports-compute-shaders.md)。 | | **supportsGeometryShaders** | 否 | 请参阅 [Device.SystemInfo.supportsGeometryShaders](/engine/6000.0/script-reference/unity-engine-device/system-info/supports-geometry-shaders.md)。 | | **supportsTessellationShaders** | 否 | 请参阅 [Device.SystemInfo.supportsTessellationShaders](/engine/6000.0/script-reference/unity-engine-device/system-info/supports-tessellation-shaders.md)。 | | **supportsInstancing** | 否 | 请参阅 [Device.SystemInfo.supportsInstancing](/engine/6000.0/script-reference/unity-engine-device/system-info/supports-instancing.md)。 | | **supportsHardwareQuadTopology** | 否 | 请参阅 [Device.SystemInfo.supportsHardwareQuadTopology](/engine/6000.0/script-reference/unity-engine-device/system-info/supports-hardware-quad-topology.md)。 | | **supports32bitsIndexBuffer** | 否 | 请参阅 [Device.SystemInfo.supports32bitsIndexBuffer](/engine/6000.0/script-reference/unity-engine-device/system-info/supports-32-bits-index-buffer.md)。 | | **supportsSparseTextures** | 否 | 请参阅 [Device.SystemInfo.supportsSparseTextures](/engine/6000.0/script-reference/unity-engine-device/system-info/supports-sparse-textures.md)。 | | **supportedRenderTargetCount** | 否 | 请参阅 [Device.SystemInfo.supportedRenderTargetCount](/engine/6000.0/script-reference/unity-engine-device/system-info/supported-render-target-count.md)。 | | **supportsSeparatedRenderTargetsBlend** | 否 | 请参阅 [Device.SystemInfo.supportsSeparatedRenderTargetsBlend](/engine/6000.0/script-reference/unity-engine-device/system-info/supports-separated-render-targets-blend.md)。 | | **supportedRandomWriteTargetCount** | 否 | 请参阅 [Device.SystemInfo.supportedRandomWriteTargetCount](/engine/6000.0/script-reference/unity-engine-device/system-info/supported-random-write-target-count.md)。 | | **supportsMultisampledTextures** | 否 | 请参阅 [Device.SystemInfo.supportsMultisampledTextures](/engine/6000.0/script-reference/unity-engine-device/system-info/supports-multisampled-textures.md)。 | | **supportsMultisampleAutoResolve** | 否 | 请参阅 [Device.SystemInfo.supportsMultisampleAutoResolve](/engine/6000.0/script-reference/unity-engine-device/system-info/supports-multisample-auto-resolve.md)。 | | **supportsTextureWrapMirrorOnce** | 否 | 请参阅 [Device.SystemInfo.supportsTextureWrapMirrorOnce](/engine/6000.0/script-reference/unity-engine-device/system-info/supports-texture-wrap-mirror-once.md)。 | | **usesReversedZBuffer** | 否 | 请参阅 [Device.SystemInfo.usesReversedZBuffer](/engine/6000.0/script-reference/unity-engine-device/system-info/uses-reversed-z-buffer.md)。 | | **npotSupport** | 否 | 请参阅 [Device.SystemInfo.npotSupport](/engine/6000.0/script-reference/unity-engine-device/system-info/npot-support.md)。 | | **maxTextureSize** | 否 | 请参阅 [Device.SystemInfo.maxTextureSize](/engine/6000.0/script-reference/unity-engine-device/system-info/max-texture-size.md)。 | | **maxCubemapSize** | 否 | 请参阅 [Device.SystemInfo.maxCubemapSize](/engine/6000.0/script-reference/unity-engine-device/system-info/max-cubemap-size.md)。 | | **maxComputeBufferInputsVertex** | 否 | 请参阅 [Device.SystemInfo.maxComputeBufferInputsVertex](/engine/6000.0/script-reference/unity-engine-device/system-info/max-compute-buffer-inputs-vertex.md)。 | | **maxComputeBufferInputsFragment** | 否 | 请参阅 [Device.SystemInfo.maxComputeBufferInputsFragment](/engine/6000.0/script-reference/unity-engine-device/system-info/max-compute-buffer-inputs-fragment.md)。 | | **maxComputeBufferInputsGeometry** | 否 | 请参阅 [Device.SystemInfo.maxComputeBufferInputsGeometry](/engine/6000.0/script-reference/unity-engine-device/system-info/max-compute-buffer-inputs-geometry.md)。 | | **maxComputeBufferInputsDomain** | 否 | 请参阅 [Device.SystemInfo.maxComputeBufferInputsDomain](/engine/6000.0/script-reference/unity-engine-device/system-info/max-compute-buffer-inputs-domain.md)。 | | **maxComputeBufferInputsHull** | 否 | 请参阅 [Device.SystemInfo.maxComputeBufferInputsHull](/engine/6000.0/script-reference/unity-engine-device/system-info/max-compute-buffer-inputs-hull.md)。 | | **maxComputeBufferInputsCompute** | 否 | 请参阅 [Device.SystemInfo.maxComputeBufferInputsCompute](/engine/6000.0/script-reference/unity-engine-device/system-info/max-compute-buffer-inputs-compute.md)。 | | **maxComputeWorkGroupSize** | 否 | 请参阅 [Device.SystemInfo.maxComputeWorkGroupSize](/engine/6000.0/script-reference/unity-engine-device/system-info/max-compute-work-group-size.md)。 | | **maxComputeWorkGroupSizeX** | 否 | 请参阅 [Device.SystemInfo.maxComputeWorkGroupSizeX](/engine/6000.0/script-reference/unity-engine-device/system-info/max-compute-work-group-size-x.md)。 | | **maxComputeWorkGroupSizeY** | 否 | 请参阅 [Device.SystemInfo.maxComputeWorkGroupSizeY](/engine/6000.0/script-reference/unity-engine-device/system-info/max-compute-work-group-size-y.md)。 | | **maxComputeWorkGroupSizeZ** | 否 | 请参阅 [Device.SystemInfo.maxComputeWorkGroupSizeZ](/engine/6000.0/script-reference/unity-engine-device/system-info/max-compute-work-group-size-z.md)。 | | **supportsAsyncCompute** | 否 | 请参阅 [Device.SystemInfo.supportsAsyncCompute](/engine/6000.0/script-reference/unity-engine-device/system-info/supports-async-compute.md)。 | | **supportsGraphicsFence** | 否 | 请参阅 [Device.SystemInfo.supportsGraphicsFence](/engine/6000.0/script-reference/unity-engine-device/system-info/supports-graphics-fence.md)。 | | **supportsAsyncGPUReadback** | 否 | 请参阅 [Device.SystemInfo.supportsAsyncGPUReadback](/engine/6000.0/script-reference/unity-engine-device/system-info/supports-async-gpu-readback.md)。 | | **supportsParallelPSOCreation** | 否 | 请参阅 [Device.SystemInfo.supportsParallelPSOCreation](/engine/6000.0/script-reference/unity-engine-device/system-info/supports-parallel-pso-creation.md)。 | | **supportsRayTracing** | 否 | 请参阅 [Device.SystemInfo.supportsRayTracing](/engine/6000.0/script-reference/unity-engine-device/system-info/supports-ray-tracing.md)。 | | **supportsRayTracingShaders** | 否 | 请参阅 [Device.SystemInfo.supportsRayTracingShaders](/engine/6000.0/script-reference/unity-engine-device/system-info/supports-ray-tracing-shaders.md)。 | | **supportsInlineRayTracing** | 否 | 请参阅 [Device.SystemInfo.supportsInlineRayTracing](/engine/6000.0/script-reference/unity-engine-device/system-info/supports-inline-ray-tracing.md)。 | | **supportsSetConstantBuffer** | 否 | 请参阅 [Device.SystemInfo.supportsSetConstantBuffer](/engine/6000.0/script-reference/unity-engine-device/system-info/supports-set-constant-buffer.md)。 | | **hasMipMaxLevel** | 否 | 请参阅 [Device.SystemInfo.hasMipMaxLevel](/engine/6000.0/script-reference/unity-engine-device/system-info/has-mip-max-level.md)。 | | **supportsMipStreaming** | 否 | 请参阅 [Device.SystemInfo.supportsMipStreaming](/engine/6000.0/script-reference/unity-engine-device/system-info/supports-mip-streaming.md)。 | | **usesLoadStoreActions** | 否 | 请参阅 [Device.SystemInfo.usesLoadStoreActions](/engine/6000.0/script-reference/unity-engine-device/system-info/uses-load-store-actions.md)。 | #### 最小设备定义 以下设备定义包含每个必要属性，没有可选属性。这是您可以拥有的最小设备定义。 **注意**：此设备定义不提供方向数据，因此模拟器假定设备支持所有方向，并且安全区域覆盖整个屏幕。 ```lang-json { "friendlyName": "Minimal Device", "version": 1, "screens": [ { "width": 1080, "height": 1920, "dpi": 450.0 } ], "systemInfo": { "operatingSystem": "Android" } } ``` #### 完整设备定义 以下设备定义包含每个必要属性和可选属性。 ```lang-json { "friendlyName": "Apple iPhone XR", "version": 1, "screens": [ { "width": 828, "height": 1792, "navigationBarHeight": 0, "dpi": 326.0, "orientations": [ { "orientation": 1, "safeArea": { "serializedVersion": "2", "x": 0.0, "y": 68.0, "width": 828.0, "height": 1636.0 }, "cutouts": [ { "serializedVersion": "2", "x": 184.0, "y": 1726.0, "width": 460.0, "height": 66.0 } ] }, { "orientation": 3, "safeArea": { "serializedVersion": "2", "x": 88.0, "y": 42.0, "width": 1616.0, "height": 786.0 }, "cutouts": [ { "serializedVersion": "2", "x": 0.0, "y": 184.0, "width": 66.0, "height": 460.0 } ] }, { "orientation": 4, "safeArea": { "serializedVersion": "2", "x": 88.0, "y": 42.0, "width": 1616.0, "height": 786.0 }, "cutouts": [ { "serializedVersion": "2", "x": 1726.0, "y": 184.0, "width": 66.0, "height": 460.0 } ] } ], "presentation": { "overlayPath": "Apple iPhone 11_Overlay.png", "borderSize": { "x": 51.0, "y": 51.0, "z": 51.0, "w": 51.0 } } } ], "systemInfo": { "deviceModel": "iPhone11,8", "deviceType": 1, "operatingSystem": "iOS 12.0", "operatingSystemFamily": 0, "processorCount": 6, "processorFrequency": 0, "processorType": "arm64e", "supportsAccelerometer": true, "supportsAudio": true, "supportsGyroscope": true, "supportsLocationService": true, "supportsVibration": true, "systemMemorySize": 2813, "unsupportedIdentifier": "n/a", "graphicsDependentData": [ { "graphicsDeviceType": 16, "graphicsMemorySize": 1024, "graphicsDeviceName": "Apple A12 GPU", "graphicsDeviceVendor": "Apple", "graphicsDeviceID": 0, "graphicsDeviceVendorID": 0, "graphicsUVStartsAtTop": true, "graphicsDeviceVersion": "Metal", "graphicsShaderLevel": 50, "graphicsMultiThreaded": true, "renderingThreadingMode": 0, "hasHiddenSurfaceRemovalOnGPU": true, "hasDynamicUniformArrayIndexingInFragmentShaders": true, "supportsShadows": true, "supportsRawShadowDepthSampling": true, "supportsMotionVectors": true, "supports3DTextures": true, "supports2DArrayTextures": true, "supports3DRenderTextures": true, "supportsCubemapArrayTextures": true, "copyTextureSupport": 31, "supportsComputeShaders": true, "supportsGeometryShaders": false, "supportsTessellationShaders": true, "supportsInstancing": true, "supportsHardwareQuadTopology": false, "supports32bitsIndexBuffer": true, "supportsSparseTextures": false, "supportedRenderTargetCount": 8, "supportsSeparatedRenderTargetsBlend": true, "supportedRandomWriteTargetCount": 8, "supportsMultisampledTextures": 1, "supportsMultisampleAutoResolve": false, "supportsTextureWrapMirrorOnce": 0, "usesReversedZBuffer": true, "npotSupport": 2, "maxTextureSize": 16384, "maxCubemapSize": 16384, "maxComputeBufferInputsVertex": 8, "maxComputeBufferInputsFragment": 8, "maxComputeBufferInputsGeometry": 0, "maxComputeBufferInputsDomain": 8, "maxComputeBufferInputsHull": 8, "maxComputeBufferInputsCompute": 8, "maxComputeWorkGroupSize": 1024, "maxComputeWorkGroupSizeX": 1024, "maxComputeWorkGroupSizeY": 1024, "maxComputeWorkGroupSizeZ": 1024, "supportsAsyncCompute": false, "supportsGraphicsFence": true, "supportsAsyncGPUReadback": true, "supportsParallelPSOCreation": true, "supportsRayTracing": false, "supportsRayTracingShaders": false, "supportsInlineRayTracing": false, "supportsSetConstantBuffer": true, "hasMipMaxLevel": true, "supportsMipStreaming": true, "usesLoadStoreActions": true, "supportedTextureFormats": [1, 2, 3, 4, 5], "supportedRenderTextureFormats": [1, 2, 3, 4, 5], "ldrGraphicsFormat": 59, "hdrGraphicsFormat": 74 } ] } } ``` ## 创建设备覆盖层 设备覆盖层是包含设备屏幕边框和其他功能（例如缺口、开孔以及屏幕矩形区域外的其他任何附加部分）的图像。可以选择将其与设备定义一起使用，以可视化呈现硬件元素如何遮挡设备屏幕，并确定触控输入何时因此失效。 设备模拟器将透明像素解释为可以点击的屏幕区域，而将任何其他颜色的不透明像素解释为硬件遮挡的区域。纹理本身可以是任何形状。 以下示例显示了两种 iPhone 型号的设备覆盖层。 **注意**：为了模拟使用设备覆盖层时看到的效果，这些示例在屏幕上可以点击的区域显示了 Unity 的默认天空盒。在实际设备覆盖层中，这些像素应该是透明的。 | Apple iPhone 8 Overlay | Apple iPhone XS Overlay | | --------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | | **Frame:** ![](/api/media?file=/engine/6000.0/media/images/device-simulator-overlay-iphone8.png) | **Frame:** ![](/api/media?file=/engine/6000.0/media/images/device-simulator-overlay-iphonexs.png) | ### 使用设备覆盖层 创建设备覆盖纹理后，要将其与设备定义一起使用，必须首先将设备覆盖纹理文件导入到项目中。 **注意**：当设备模拟器加载设备覆盖纹理时，设备模拟器会尝试为设备覆盖纹理启用 **Read/Write**。如果无法实现，则设备模拟器会显示纹理，但无法使用纹理来遮罩输入。这意味着，如果单击设备覆盖层应遮挡的屏幕缺口和其他区域，则设备模拟器会检测输入。为确保不会发生这种情况，导入设备覆盖纹理时，请在 Texture Import Settings 窗口中启用 **Read/Write**。 当设备覆盖纹理位于项目中时，打开设备定义文件，然后在定义了设备所支持的屏幕的对象中添加 [presentation](#presentation) 属性。在此处，设置图像文件的路径 (`overlayPath`) 和边框的大小 (`borderSize`)。有关如何执行此操作的示例，请参阅以下设备定义文件： ```lang-json { "friendlyName": "Minimal Device with Overlay", "version": 1, "screens": [ { "width": 1080, "height": 1920, "dpi": 450.0, "presentation": { "overlayPath": "Overlays/MinimalDeviceOverlay.png", "borderSize": { "x": 51.0, "y": 51.0, "z": 51.0, "w": 130.0 } } } ], "systemInfo": { "operatingSystem": "Android" } } ``` **注意**：设备覆盖纹理文件的路径可以是相对于设备定义文件的路径，也可以是相对于包含 **Assets** 或 **Packages** 目录的 Unity 项目目录的路径。例如，如果设备定义文件位于 **Assets/Devices** 目录中，而设备覆盖文件位于 **Assets/Devices/Overlays** 目录中，则以下文件路径均有效： * 相对于设备定义文件：**Overlays/MinimalDeviceOverlay.png** * 相对于包含 **Assets** 目录的目录：**Assets/Devices/Overlays/MinimalDeviceOverlay.png**