文档

Unity 引擎

Unity 引擎

iOS 脚本

了解 iOS 脚本。
阅读时间11 分钟最后更新于 5 天前

iOS Devices 的大多数功能通过 Input 和 Handheld 类公开。对于跨平台项目,Unity_IPHONE 用于有条件地编译 iOS 指定的 C# 代码。

设备Properties

您可以访问特定于设备的 Properties 数量。请参阅以下脚本参考页面:

反盗版检查

破解应用程序程序的一种常见方法是删除 AppStore DRM 保护,然后自由重新分发。使用 Unity 的反盗版检查可查找应用程序在提交到 AppStore 后是否被更改。
使用 Application.genuine 属性检查应用程序是否为正版(未被破解)。如果该属性返回
false
,则可以警告 Users 他们正在使用被破解的应用程序,也可以禁用某些函数。
注意
使用 Application.genuineCheckAvailable 以及
Application.genuine
来验证应用程序完整性。由于访问 Application.genuine 属性是一项资源密集型操作,因此不应在帧更新或其他时间紧迫的代码期间执行此操作。

振动Support

您可以通过调用 Handheld.Vibrate 来触发器振动。没有振动硬件的Devices会忽略此调用。

练习指示器

移动操作系统具有内置 Activity 指示器,可在慢速操作时使用。有关示例,请参阅 Handheld.StartActivityIndicator 文档。

屏幕方向

您可以ON iOS Android Devices上Control应用程序程序的屏幕方向。通过检测方向Change或强制指定的方向,您可以创建取决ON用户握持设备方式的应用行为。
要检索设备方向,请访问 Screen.direction 属性。方向可以是以下之一:

orientation:

行为

Portrait设备处于纵向模式,设备直立,Home 按钮位于底部。
PortraitUpsideDown设备处于纵向模式,但上下颠倒,设备直立,Home 按钮位于顶部。
LandscapeLeft设备处于横向模式,设备直立,Home屏幕按钮位ON右侧。
右翼景观设备处于横向模式,设备直立,Home屏幕按钮位ON左。
将屏幕方向设置为上述方向之一或使用ScreenOrientation.自动旋转来控制屏幕方向。When Enable Autorotation(启用自动旋转)时,仍然可以根据具体情况禁用某些 ON 方向。
如需了解更多信息,请参阅以下 API 文档:
应用程序程序的屏幕方向可能会根据用户设置的设备方向ON有所不同,无论应用程序程序的默认方向设置如何。
下表显示了为应用程序设置的 Default Screen Orientation 以及应用程序根据 ON 设备方向加载的实际方向。

Default Screen Orientation:自动旋转

**Default Screen Orientation:Portrait

**Default Screen Orientation:Landscape(横向)

Device Orientation(设备方向)自动旋转**应用程序程序屏幕以纵向加载,并可在纵向、右横向和左向之间Rotate(不包括纵向颠方向)。
**注意:**ON iPad,应用程序屏幕根据设备方向以纵向或横向加载。屏幕可在纵向、纵向颠倒、横向右和横向左方向之间 Rotate。
应用程序屏幕会加载并保持锁定在纵向方向。虽然允许纵向颠倒方向,但屏幕不会向该方向 Rotate。
**注意:**ON iPad,应用程序屏幕以纵向加载,并可在纵向和纵向之间上下颠倒旋转。如果启动时设备方向为横向,则启动画面可以按横向加载。
启动画面的加载方向与设备方向相同。加载SceneWhen,应用程序程序屏幕在横向中加载,并可在横向左方向或横向右方向之间Rotate。
**注意:**ON iPad,应用程序屏幕以横向加载,并可在横向左和横向右方向之间 Rotate。如果设备方向ON启动时为纵向,则启动启动画面可以纵向加载。
Device Orientation(设备方向)纵向锁定**应用程序屏幕会加载并保持锁定在纵向方向。
**注意:**在纵向方向时,如果将纵向的 ScreenOrientation.AutoRotation 属性设置为 false,应用程序屏幕将旋转到横向。如果现在将横向的 ScreenOrientation.AutoRotation 属性设置为 false,则屏幕方向保持不变。
应用程序屏幕会加载并保持锁定在纵向方向。启动画面以方向加载,但应用程序程序屏幕在加载SceneWhen以横向加载。默认情况下,应用程序屏幕保持锁定在横向左方向。
**注意:**ON iPad,启动画面以纵向方向加载,Scene 以横向方向加载。应用程序程序屏幕保持锁定在方向。
Device Orientation(设备方向)景观锁定**不适用,因为 iPhone 没有横向锁定设置。如果用户在应用程序处于横向时关闭设备自动旋转设置,应用程序屏幕将旋转到纵向并保持锁定。
**注意:**ON iPad,应用程序加载并保持锁定在横向方向。
不适用,因为 iPhone 没有横向锁定设置。应用程序保持锁定在纵向方向。
**注意:**ON iPad,启动画面以横向加载,Scene 以纵向方向加载。应用程序屏幕保持锁定在纵向方向。
不适用,因为 iPhone 没有横向锁定设置。应用程序程序屏幕以横向加载,并且在应用程序程序加载When可以保持锁定在横向左方向或横向右方向。
**注意:**ON iPad,应用程序屏幕以横向加载,并根据设备方向保持锁定在横向左或横向右方向。

iPad 多任务处理模式

iPadOS 支持多任务模式,允许Users同时运行多个个Applications程序。可用模式取决ON iPadOS 版本:

iPadOS version

可用模式

iPadOS 9 to 15Split 视图、Slide Over
iPadOS 16 to 18Split 视图、Slide Over、Stage 管理员
iPadOS 26 及更高版本全屏幕程序、窗口化应用程序、Stage 管理员
在除全屏幕用程序之外的All模式下,应用程序程序都可以与Other应用程序一起在相当大的Space中运行。ON iPadOS 26 及更高版本上,Windowed Apps 和 Stage 管理员 都允许自由调整Windows大小和位置。Stage 管理员 通过添加工作空间分组ON构建,允许Users将Windows组织成可在其中切换的设置。

屏幕 API 行为

When的应用程序程序在多任务模式下运行时,以下行为Apply:
注意
应用程序程序无法Control窗口大小。窗口尺寸由用户和 Operating System 决定。

方向锁定 Applications

如果应用程序在 Player Settings 中将方向限制为仅纵向或仅横向,则以下行为适用于多任务模式:
  • 应用程序窗口保持锁定方向的正确宽高比。
  • 屏幕方向继续上报锁定的方向。
方向锁定的应用程序程序在进入全模式式When保持其宽高比。如果设备的方向与应用程序的锁定方向不同,例如,横向设备上的仅限纵向的应用程序,则应用程序为文本框。

局限性

  • **ON iPadOS 26及更高版本的方向锁定:**仅当 Player Settings 中已启用 Requires全屏 时,才能使用屏幕。方向进行程序化方向锁定。When Requires Fullscreen is Disabled,将
    Screen.orientation
    设置为指定方向 ON iPadOS 26 及更高版本没有特效,即使当应用程序处于全屏模式时也是如此。
  • **Window 大小 Control:**应用程序无法设置最小或最大窗口大小。
  • 窗口模式下的 SetResolution:Screen.SetResolution 会更改渲染 Resolution 但不调整窗口大小。调用后,屏幕宽度和屏幕高度上报渲染 Resolution 而不是窗口大小。

确定设备生成

不同的设备世代具有不同的性能并Support不同的功能。使用 iOS.DeviceGeneration 属性可查询设备的生成。

显示Cutout

ON某些显示器上,屏幕的某些区域可能会被遮挡或无法使用,因为Other硬件占用了该Space。使用 Screen.cutouts 返回每个 Cutout 周围的包围框形列表。
iOS Devices 不提供原生 API 来获取显示 Cutout 信息,因此每个可用 iOS 设备的 Cutout 都在 Xcode Project 中进行硬编码。您可以在 Unity Xcode Project
ReportSafeAreaChangeForView
函数(位于
UnityView.mm
文件中)中修改现有数据或添加其他 Devices。

录制游戏重播

您可以使用 ReplayKit 录制游戏的音频和视频,以及从设备的麦克风和 Camera 捕获的音频和视频评论。