CoronaSplashControl.*

类型 (特殊)
修订版 版本 2024.3703
关键词 屏幕启动控制、启动屏幕
平台 Android、iOS

概述

该特殊插件可启用在设备上启动应用时显示默认 Solar2D 品牌启动屏幕的控制。该插件不仅仅为 Lua 代码添加功能,还使您能够在 build.settings 中控制启动屏幕。

注意
  • 在 iOS 上,假设启动屏幕没有禁用,iOS 启动屏幕将在启动屏幕前出现。如果禁用启动屏幕,该启动屏幕将在应用完全加载前出现,然后您的第一个屏幕/场景将出现。

集成

移除启动屏幕

若要移除启动屏幕,请将 splashScreen 表添加到项目的 build.settings 中,将 enable 键设置为 false

settings =
{
    splashScreen = 
    {
        enable = false
    },
}

或者,您可以在每个平台上按如下方式移除启动屏幕

settings =
{
    splashScreen =
    {
        ios = {
            enable = false
        },
        android = {
            enable = true
        }
    },
}

自定义启动屏幕

如果您想显示自己的自定义启动屏幕,请在 build.settings 中包含 splashScreen 表(如上所述),但将 enable 键设置为 true,并添加一个定义图像名称的 image 键。例如

settings =
{
    splashScreen = 
    {
        enable = true,
        image = "mySplashScreen.png"
    },
}

或者,您可以在每个平台上按如下方式移除启动屏幕

settings =
{
    splashScreen =
    {
        ios = {
            enable = true,
            image = "mySplashScreen_iOS.png"
        },
        android = {
            enable = true,
            image = "mySplashScreen_Android.png"
        }
    },
}

对于自定义实现,image 指示项目中任何图像文件的路径。该图像将显示在黑色背景上,并且它将匹配应用的默认方向,并按比例调整到当前设备的屏幕大小。您可能需要多尝试才能获得最适合您启动屏幕的图像,但如果它足够大,足以供您打算在其上运行应用的最大设备使用,则只需一张图像即可。

注意

由于 build.settings 不适用于通过 Solar2D 原生执行的应用构建,因此在这些情况下需要进行特殊处理以自定义启动屏幕。请参阅下面的 Solar2D 原生 部分了解详情。

Solar2D 原生

由于 build.settings 不适用于通过 Solar2D 原生执行的应用构建,因此在这些情况下需要进行特殊处理以自定义启动屏幕