기기 추가
기기 시뮬레이터에 새 기기를 추가하려면 기기 정의와 기기 오버레이를 생성합니다.
기기 정의는 Unity 프로젝트에서 확장자가 .device인 텍스트 파일입니다. 여기에는 기기의 프로퍼티를 설명하는 JSON 파일이 포함됩니다.
기기 오버레이는 기기 화면의 테두리와 노치, 펀치아웃, 직사각형 화면에 대한 기타 추가 사항을 함께 포함하는 이미지입니다. 기기 정의와 함께 선택적으로 사용하여 하드웨어 요소가 기기 화면을 방해하는 방식을 시각화하고 결과적으로 터치 입력이 실패하는 경우를 알아낼 수 있습니다.
기기 정의 생성
기기 정의는 기기를 나타내는 JSON 파일입니다. 필수 프로퍼티와 일부 선택적 프로퍼티가 모두 들어 있습니다. 기기 정의 파일에 오류가 있으면 파일을 선택할 때 인스펙터에 오류가 나타납니다.
스키마
| 프로퍼티 | 필수 | 설명 |
|---|---|---|
| friendlyName | 지원 | 기기의 UI에 표시할 이름입니다. |
| version | 지원 | 기기 정의 파일의 버전을 나타냅니다. 현재 버전은 1입니다. |
| screens | 지원 | 기기를 시뮬레이션할 화면을 각각 설명하는 오브젝트 리스트입니다. 여기에는 하나 이상의 화면이 포함되어야 합니다. 각 화면 오브젝트의 스키마에 대한 자세한 내용은 화면을 참조하십시오. |
| systemInfo | 지원 | 기기의 기능을 설명하는 오브젝트입니다. 이 오브젝트의 값은 SystemInfo에 매핑됩니다. 시스템 정보 오브젝트의 스키마에 대한 자세한 내용은 SystemInfo를 참조하십시오. |
화면
| 프로퍼티 | 필수 | 설명 |
|---|---|---|
| width | 지원 | 화면의 너비(픽셀 단위)입니다. |
| height | 지원 | 화면의 높이(픽셀 단위)입니다. |
| navigationBarHeight | 지원 안 함 | 전체 화면이 아닐 때 일부 기기 화면에 표시되는 Android 내비게이션 바의 높이(픽셀 단위)입니다. |
| dpi | 지원 | 화면의 dpi입니다. |
| orientations | 지원 안 함 | 화면이 시뮬레이션할 수 있는 방향을 각각 설명하는 오브젝트 리스트입니다. 이 프로퍼티에 값을 설정하지 않으면 화면이 모든 방향을 지원합니다. 각 방향 오브젝트의 스키마에 대한 자세한 내용은 방향을 참조하십시오. |
| presentation | 지원 안 함 | 기기 오버레이를 설명하는 오브젝트입니다. 이 오브젝트의 스키마에 대한 자세한 내용은 프레젠테이션을 참조하십시오. |
방향
| 프로퍼티 | 필수 | 설명 |
|---|---|---|
| orientation | 지원 | 화면 방향입니다. 이 프로퍼티의 값은 ScreenOrientation 열거형에 매핑되는 숫자입니다. |
| safeArea | 지원 안 함 | 화면의 세이프 영역을 결정하는 Rect입니다. 이 프로퍼티의 값을 설정하지 않으면 시뮬레이터는 전체 화면을 세이프 영역으로 가정합니다. |
| cutouts | 지원 안 함 | 콘텐츠를 표시할 수 없는 화면 영역을 지정하는 Rect 리스트입니다. |
프레젠테이션
| 프로퍼티 | 필수 | 설명 |
|---|---|---|
| overlayPath | 지원 안 함 | 기기 정의 파일과 기기 오버레이로 사용할 이미지의 상대 경로입니다. |
| borderSize | 지원 안 함 | 오버레이에서 화면이 시작되는 지점까지의 거리(픽셀 단위)입니다. |
시스템 정보
이 오브젝트의 프로퍼티는 기기의 기능과 시스템 정보를 설명합니다. 시스템 정보를 설명하기 때문에 SystemInfo의 프로퍼티에 매핑되는 경우가 많습니다.
| 프로퍼티 | 필수 | 설명 |
|---|---|---|
| deviceModel | 지원 안 함 | Device.SystemInfo.deviceModel을 참조하십시오. |
| deviceType | 지원 안 함 | Device.SystemInfo.deviceType을 참조하십시오. |
| operatingSystem | 지원 | Device.SystemInfo.operatingSystem을 참조하십시오. |
| operatingSystemFamily | 지원 안 함 | Device.SystemInfo.operatingSystemFamily를 참조하십시오. |
| processorCount | 지원 안 함 | Device.SystemInfo.processorCount를 참조하십시오. |
| processorFrequency | 지원 안 함 | Device.SystemInfo.processorFrequency를 참조하십시오. |
| processorType | 지원 안 함 | Device.SystemInfo.processorType을 참조하십시오. |
| supportsAccelerometer | 지원 안 함 | Device.SystemInfo.supportsAccelerometer를 참조하십시오. |
| supportsAudio | 지원 안 함 | Device.SystemInfo.supportsAudio를 참조하십시오. |
| supportsGyroscope | 지원 안 함 | Device.SystemInfo.supportsGyroscope을 참조하십시오. |
| supportsLocationService | 지원 안 함 | See Device.SystemInfo.supportsLocationService. |
| supportsVibration | 지원 안 함 | Device.SystemInfo.supportsVibration을 참조하십시오. |
| systemMemorySize | 지원 안 함 | Device.SystemInfo.systemMemorySize를 참조하십시오. |
| unsupportedIdentifier | 지원 안 함 | Device.SystemInfo.unsupportedIdentifier를 참조하십시오. |
| graphicsDependentData | 지원 안 함 | 기기가 지원하는 그래픽스 API를 각각 설명하는 오브젝트 리스트입니다. 각 오브젝트의 스키마에 대한 자세한 내용은 graphicsDependentData를 참조하십시오. |
graphicsDependentData
오브젝트의 프로퍼티는 기기가 지원하는 그래픽스 API를 설명합니다.
최소 기기 정의
다음 기기 정의에는 모든 필수 프로퍼티가 포함되어 있고 선택적 프로퍼티는 없습니다. 이것은 가질 수 있는 최소 기기 정의입니다.
참고: 이 기기 정의는 방향 데이터를 제공하지 않으므로 시뮬레이터는 기기가 모든 방향을 지원하고 세이프 영역이 전체 화면을 덮는다고 가정합니다.
{
"friendlyName": "Minimal Device",
"version": 1,
"screens": [
{
"width": 1080,
"height": 1920,
"dpi": 450.0
}
],
"systemInfo": {
"operatingSystem": "Android"
}
}
완전한 기기 정의
다음 기기 정의에는 모든 필수 및 선택적 프로퍼티가 포함되어 있습니다.
{
"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,
"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 오버레이 | Apple iPhone XS 오버레이 |
|---|---|
 |
 |
기기 오버레이 사용
기기 오버레이 텍스처를 만든 후 기기 정의와 함께 사용하려면 먼저 기기 오버레이 텍스처 파일을 프로젝트로 가져와야 합니다.
참고: 기기 시뮬레이터가 기기 오버레이 텍스처를 로드할 때 Read/Write 활성화를 시도합니다. 활성화하지 않은 경우 기기 시뮬레이터는 텍스처를 표시하지만 텍스처를 사용하여 입력을 마스킹할 수 없습니다. 즉, 기기 오버레이가 마스킹을 적용해야 하는 화면의 노치 및 기타 영역을 클릭하면 기기 시뮬레이터가 입력을 감지합니다. 이런 일이 발생하지 않도록 하려면 기기 오버레이 텍스처를 임포트할 때 Texture Import Settings 창에서 Read/Write를 활성화합니다.
기기 오버레이 텍스처가 프로젝트에 있을 때 기기 정의 파일을 열고 해당 기기 화면을 정의하는 오브젝트에서 presentation 프로퍼티를 추가합니다. 여기에서 이미지 파일의 경로(overlayPath)와 테두리 크기(borderSize)를 설정합니다. 이를 수행하는 방법의 예는 다음 기기 정의 파일을 참조하십시오.
{
"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"
}
}
참고: 기기 오버레이 텍스처 파일의 경로는 기기 정의 파일을 기준으로 하거나 Unity 프로젝트의 Assets 또는 Packages 디렉토리가 포함된 디렉토리를 기준으로 할 수 있습니다. 예를 들어, 기기 정의 파일이 Assets/Devices 디렉토리에 있고 기기 오버레이 파일이 Assets/Devices/Overlays 디렉토리에 있는 경우 다음 파일 경로는 모두 유효합니다.
- 기기 정의 파일 기준: Overlays/MinimalDeviceOverlay.png
- Assets 디렉토리가 포함된 디렉토리 기준: Assets/Devices/Overlays/MinimalDeviceOverlay.png
Copyright © 2023 Unity Technologies
优美缔软件（上海）有限公司 版权所有
"Unity"、Unity 徽标及其他 Unity 商标是 Unity Technologies 或其附属机构在美国及其他地区的商标或注册商标。其他名称或品牌是其各自所有者的商标。
公安部备案号:
31010902002961