Unity 기기 시뮬레이터 사용 가이드
Unity에서 기기를 추가하고 시뮬레이션하는 방법에 대한 가이드를 제공합니다. 이 문서는 기기 정의 및 기기 오버레이 생성에 대한 정보를 포함하고 있습니다.
기기 정의
기기 정의는 Unity 프로젝트에서 확장자가 .device인 텍스트 파일이며, JSON 형식으로 기기의 속성을 설명합니다. 기기 정의를 통해 하드웨어 요소가 기기 화면을 방해하는 방식을 시각화하고 터치 입력 실패를 모니터링할 수 있습니다.
필수 속성
| 속성 | 필수 여부 | 설명 |
|---|---|---|
friendlyName |
필수 | 지원 기기의 UI에 표시할 이름입니다. |
version |
필수 | 기기 정의 파일의 버전입니다. 현재 버전은 1입니다. |
screens |
필수 | 시뮬레이션할 화면을 설명하는 오브젝트 리스트입니다. |
systemInfo |
필수 | 기기의 기능을 설명하는 오브젝트입니다. |
화면 속성
| 속성 | 필수 여부 | 설명 |
|---|---|---|
width |
필수 | 화면의 너비 (픽셀 단위) |
height |
필수 | 화면의 높이 (픽셀 단위) |
navigationBarHeight |
선택적 | Android 내비게이션 바의 높이 (픽셀 단위) |
dpi |
필수 | 화면의 dpi |
시스템 정보
| 속성 | 필수 여부 | 설명 |
|---|---|---|
deviceModel |
선택적 | 기기의 모델 이름 |
deviceType |
선택적 | 기기의 타입 |
operatingSystem |
선택적 | 기기의 운영체제 |
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
}
]
}
],
"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",
"processorCount": 6,
"systemMemorySize": 2813,
"graphicsDependentData": [...]
}
}
기기 오버레이
기기 오버레이는 기기 화면의 테두리, 노치 및 펀치아웃 등을 포함하는 이미지입니다. 기기 정의와 함께 사용하여 하드웨어 요소가 기기 화면을 방해하는 방식을 시각화할 수 있습니다.
기기 오버레이 사용
- 기기 오버레이 텍스처 파일을 프로젝트로 가져옵니다.
- 기기 정의 파일을 열고, 화면을 정의하는 오브젝트에
presentation속성을 추가합니다.
기기 오버레이 예제
{
"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 디렉토리에서 상대적인 경로가 사용될 수 있습니다.
이 문서를 통해 Unity의 기기 시뮬레이터를 활용하여 다양한 기기를 시뮬레이션하고 테스트할 수 있습니다. 추가적인 질문이 있다면 Unity 공식 문서를 참조하시기 바랍니다.