기술 자료

Unity 엔진

Unity 엔진

iOS 스크립팅

iOS용 스크립팅 이해합니다.
읽는 시간 6분최근 업데이트: 9일 전

iOS 기기의 대부분의 기능은 Input 및 Handheld 클래스를 통해 노출됩니다. 크로스 플랫폼 프로젝트의 경우 iOS 전용 C# 코드를 조건부로 컴파일하기 위해 UNITY_IPHONE을 정의합니다.

디바이스 프로퍼티

액세스할 수 있는 여러 기기별 프로퍼티가 있습니다. 다음에 대한 스크립트 레퍼런스 페이지를 참조하십시오.

불법 복제 방지 검사

애플리케이션을 해킹하는 일반적인 방법은 AppStore DRM 보호를 제거한 다음 무료로 재배포하는 것입니다. Unity 불법 복제 방지 검사를 사용하여 애플리케이션이 AppStore에 제출된 후 변경되었는지 확인합니다.
Application.genuine 프로퍼티를 사용하여 애플리케이션이 정품인지 확인합니다(해킹되지 않음). 등록 정보가
false
를 반환하면 사용자에게 해킹된 앱을 사용하고 있다고 경고하거나 특정 기능을 비활성화할 수 있습니다.
참고
Application.genuineCheckAvailable을
Application.genuine
와 함께 사용하여 애플리케이션 무결성을 확인합니다. Application.genuine 프로퍼티에 액세스하는 작업은 리소스를 많이 소모하므로 프레임 업데이트 또는 기타 시간 크리티컬 코드 중에 수행해서는 안 됩니다.

진동 지원

Handheld.Vibrate를 호출하여 진동을 트리거할 수 있습니다. 진동 하드웨어가 없는 기기는 이 호출을 무시합니다.

활동 표시기

모바일 운영체제에는 느린 작동 중에 사용할 수 있는 빌트인 활동 표시기가 있습니다. 예제는 Handheld.StartActivityIndicator 문서를 참조하십시오.

화면 방향

iOS 및 Android 장치에서 모두 애플리케이션의 화면 방향을 제어할 수 있습니다. 방향 변경을 감지하거나 특정 방향을 강제 적용하면 사용자가 기기를 잡는 방식에 따라 앱 동작을 생성할 수 있습니다.
디바이스 방향을 검색하려면 Screen.orientation 프로퍼티에 액세스합니다. 방향은 다음 중 하나일 수 있습니다.

orientation:

동작

Portrait기기가 세워진 상태에서 홈 버튼이 하단에 있는 세로 모드입니다.
PortraitUpsideDown디바이스가 세워진 상태에서 홈 버튼이 상단에 있는 세로 모드입니다.
LandscapeLeft기기가 세워진 상태에서 홈 버튼이 오른쪽에 있는 가로 모드입니다.
LandscapeRight기기가 세워진 상태에서 홈 버튼이 왼쪽에 있는 가로 모드입니다.
위 방향 중 하나로 Screen.orientation을 설정하거나 ScreenOrientation.AutoRotation을 사용하여 화면 방향을 제어합니다. 자동 회전을 활성화하면 대소문자별로 일부 방향을 비활성화할 수 있습니다.
자세한 내용은 다음 API 기술 자료를 참고하십시오.
애플리케이션의 기본 방향 설정과 관계없이 사용자가 설정한 기기 방향에 따라 애플리케이션의 화면 방향이 달라질 수 있습니다.
다음 표에는 애플리케이션의 기본 화면 방향 설정과 기기 방향에 따라 애플리케이션이 로드되는 실제 방향이 나와 있습니다.

기본 화면 방향: 자동 정렬

**기본 화면 방향: Portrait

**기본 화면 방향: Landscape

Device Orientation 자동 정렬**애플리케이션 화면은 세로 화면에 로드되며 세로, 가로 오른쪽, 가로 왼쪽 방향 간에 회전할 수 있습니다(세로 위아래 방향 제외).
참고: iPad에서 애플리케이션 화면은 기기 방향에 따라 세로 또는 가로 방향으로 로드됩니다. 화면은 세로, 세로 위아래, 가로 오른쪽, 가로 왼쪽 방향 간에 회전할 수 있습니다.
애플리케이션 화면이 로드되고 세로 방향으로 계속 고정됩니다. 세로 위쪽 방향이 허용되더라도 화면은 해당 방향으로 회전하지 않습니다.
참고: iPad에서는 애플리케이션 화면이 세로 화면으로 로드되며 세로 화면과 세로 화면의 위아래 방향 간에 회전할 수 있습니다. 기기 방향이 실행 시 랜드스케이프인 경우 스플래시 화면이 가로 방향으로 로드될 수 있습니다.
스플래시 화면은 기기 방향과 동일한 방향으로 로드됩니다. 애플리케이션 화면은 씬이 로드될 때 가로 화면에 로드되며 가로 왼쪽 또는 오른쪽 방향 간에 회전할 수 있습니다.
참고: iPad에서는 애플리케이션 화면이 랜드스케이프에서 로드되며, 랜드스케이프 왼쪽 및 랜드스케이프 오른쪽 방향 사이에서 회전할 수 있습니다. 기기 방향이 실행 시 세로 화면인 경우 스플래시 화면이 세로 화면으로 로드될 수 있습니다.
Device Orientation 세로 잠금**애플리케이션 화면이 로드되고 세로 방향으로 계속 고정됩니다.
참고: 세로 방향에서 세로에 대한 ScreenOrientation.AutoRotation 프로퍼티를 false로 설정하면 애플리케이션 화면이 가로 방향으로 회전합니다. 이제 가로에 대한 ScreenOrientation.AutoRotation 프로퍼티를 false로 설정하면 화면 방향이 변경되지 않습니다.
애플리케이션 화면이 로드되고 세로 방향으로 계속 고정됩니다.스플래시 화면은 세로 방향으로 로드되지만, 애플리케이션 화면은 씬이 로드될 때 가로 방향으로 로드됩니다. 기본적으로 애플리케이션 화면은 가로 왼쪽 방향으로 계속 고정됩니다.
참고: iPad에서는 스플래시 화면이 세로 방향으로 로드되고 씬은 가로 방향으로 로드됩니다. 애플리케이션 화면은 가로 방향으로 계속 고정됩니다.
Device Orientation 가로 잠금**iPhone에 가로 잠금 설정이 없으므로 적용할 수 없습니다. 애플리케이션이 가로 상태인 동안 사용자가 기기 자동 회전 설정을 끄면 애플리케이션 화면이 회전하고 세로 방향으로 계속 고정됩니다.
참고: iPad에서는 애플리케이션이 로드되고 가로 방향으로 계속 고정됩니다.
iPhone에 가로 잠금 설정이 없으므로 적용할 수 없습니다. 애플리케이션은 세로 방향으로 계속 잠겨 있습니다.
참고: iPad에서는 스플래시 화면이 가로 방향으로 로드되고 씬은 세로 방향으로 로드됩니다. 애플리케이션 화면은 세로 방향으로 계속 고정됩니다.
iPhone에 가로 잠금 설정이 없으므로 적용할 수 없습니다. 애플리케이션 화면은 가로 화면에서 로드되며 애플리케이션이 로드될 때 가로 왼쪽 또는 가로 오른쪽 방향으로 모두 잠글 수 있습니다.
참고: iPad에서 애플리케이션 화면은 가로 화면으로 로드되며 디바이스 방향에 따라 가로 왼쪽 또는 오른쪽 방향으로 계속 고정됩니다.

iPad 멀티태스킹 모드

iPadOS는 사용자가 여러 애플리케이션을 동시에 실행할 수 있도록 해주는 멀티태스킹 모드를 지원합니다. 사용 가능한 모드는 iPadOS 버전에 따라 다릅니다.

iPadOS version

사용 가능한 모드

iPadOS 9 to 15분할 뷰(Split View), 슬라이드오버(Slice Over)
iPadOS 16 to 18분할 뷰, 슬라이드오버, 스테이지 관리자
iPadOS 26 and later전체 화면 앱, 창형 앱, 스테이지 관리자
전체 화면 앱 제외한 모든 모드에서 애플리케이션은 크기 조정이 가능한 공간에서 다른 앱 함께 실행할 수 있습니다. iPadOS 26 이상에서는 창 앱 스테이지 관리자 모두 자유롭게 크기를 조절하고 위치를 변경할 수 있는 Windows 지원합니다. Stage Manager는 사용자가 Windows 전환할 수 있는 세트로 구성할 수 있도록 하는 작업 공간 그룹을 추가하여 창 앱 기반으로 빌드합니다.

화면 API 동작

애플리케이션이 멀티태스킹 모드에서 실행되는 경우 다음 동작이 적용됩니다.
참고
애플리케이션이 창 크기를 제어할 수 없습니다. 사용자와 운영체제가 창 크기를 결정합니다.

방향 잠금 애플리케이션

애플리케이션이 플레이어 설정에서 세로 전용 또는 가로 전용으로 방향을 제한하는 경우 멀티태스킹 모드에서 다음 동작이 적용됩니다.
  • 애플리케이션 창은 잠긴 방향에 대한 올바른 종횡비를 유지합니다.
  • Screen.orientation이 계속해서 잠긴 방향을 보고합니다.
방향 잠금이 있는 애플리케이션은 전체 화면 모드로 전환될 때 종횡비를 유지합니다. 기기의 방향이 애플리케이션의 잠긴 방향과 다른 경우(예: 가로 기기의 세로 전용 앱) 애플리케이션은 문자 상자가 됩니다.

제한

  • iPadOS 26 이상의 방향 잠금: Screen.orientation을 사용하는 프로그래밍 방향 잠금은 플레이어 설정에서 전체 화면 요구 기능이 활성화된 경우에만 작동합니다. 필요 화면을 비활성화하면 앱이 전체 화면 모드일 때도 iPadOS 26 이상에서 특정 방향으로
    Screen.orientation
    를 설정할 수 없습니다.
  • 창 크기 제어: 애플리케이션에서 최소 또는 최대 창 크기를 설정할 수 없습니다.
  • 창 모드에서 해상도 설정: Screen.SetResolution은 렌더링 해상도를 변경하지만 창의 크기를 조절하지 않습니다. 호출한 후에는 Screen.width 및 Screen.height가 창 크기보다 렌더 해상도를 보고합니다.

디바이스 생성 결정

기기 세대마다 성능이 다르며 다양한 기능을 지원합니다. iOS.DeviceGeneration 프로퍼티를 사용하여 기기의 생성을 쿼리합니다.

디스플레이 컷아웃

일부 디스플레이에서는 화면의 특정 영역이 가려지거나 다른 하드웨어로 인해 작동하지 않을 수 있습니다. 각 컷아웃 주변의 바운딩 상자 목록을 반환하려면 Screen.cutouts를 사용합니다.
iOS 기기는 디스플레이 컷아웃 정보를 가져오기 위한 네이티브 API 제공하지 않으므로 컷아웃은 사용 가능한 각 iOS 기기에 대한 Xcode 프로젝트에서 하드코딩됩니다. 기존 데이터를 수정하거나
UnityView.mm
파일에 있는 Unity Xcode 프로젝트
ReportSafeAreaChangeForView
함수에서 추가 디바이스를 추가할 수 있습니다.

게임의 리플레이 기록

ReplayKit을 사용하여 장치의 마이크와 카메라에서 캡처한 오디오 및 비디오 코멘트와 함께 게임 오디오 및 비디오를 녹화할 수 있습니다.