系统/操作系统库

本指南概述了 Corona system 和 os 库。总的来说，以下调用用于收集系统信息和控制系统功能 — 获取设备信息、启用多点触控、控制空闲时间、加速度计、GPS 等 — 并处理系统时间、日期和其他操作系统相关信息。

系统库

API 描述
system.getInfo() 返回应用程序运行所在系统的相关信息。
system.openURL() 在设备浏览器中打开网页、创建电子邮件、拨打电话号码或打开文件。
system.canOpenURL() 返回一个布尔值，确认是否可以通过 system.openURL() 打开 URL。
system.pathForFile() 使用系统定义的目录作为基准生成绝对路径。有关更多信息，请参阅读取和写入文件。
system.CachesDirectory 与 system.pathForFile() 一起使用，用于创建在应用程序启动之间可用的存储和检索文件的路径。
system.DocumentsDirectory 与 system.pathForFile() 一起使用，用于创建在应用程序会话之间需要持久存储和检索文件的路径。
system.ResourceDirectory 与 system.pathForFile() 一起使用，用于创建检索所有应用程序资产所在文件的路径。
system.TemporaryDirectory 与 system.pathForFile() 一起使用，用于创建仅在应用程序运行时需要持久存储和检索文件的路径。
system.getPreference() 以字符串形式返回系统偏好设置值（ui 或 locale）。
system.getInputDevices() 返回当前连接到系统的 InputDevice 设备数组，例如触摸屏、键盘、鼠标、操纵杆等。
system.getTimer() 返回自应用程序启动以来的毫秒数。
system.orientation 返回一个标识设备方向的字符串。
system.setTapDelay() 设置检测到点击与传递点击事件之间的时间延迟。
system.activate() 激活系统级功能，例如多点触控。
system.deactivate() 停用由 system.activate() 激活的系统级功能。
system.scheduleNotification() 计划在将来传递本地通知事件。
system.cancelNotification() 从计划程序、状态栏或通知中心删除指定的通知。
system.setIdleTimer() 控制是否启用系统空闲计时器（自动屏幕变暗和睡眠）。
system.getIdleTimer() 确定是否启用了系统空闲计时器。
system.setLocationAccuracy() 将 位置 (GPS) 事件的所需精度设置为以米为单位的距离。
system.setLocationThreshold() 设置每个 位置 (GPS) 事件之间的距离（以米为单位）。
system.setAccelerometerInterval() 设置 加速度计 事件的频率。
system.setGyroscopeInterval() 以赫兹为单位设置 陀螺仪 事件的频率。
system.hasEventSource() 返回系统是否传递与 eventName 对应的事件。
system.vibrate() 使手机振动。在 Corona 模拟器上，这会触发系统蜂鸣声。

操作系统库

API 描述
os.clock() 返回程序使用的 CPU 时间的大约秒数。
os.date() 返回格式化字符串或包含日期和时间的表格。
os.time() 返回从 1970 年开始的当前时间（以秒为单位），或表格指定的日期和时间。
os.difftime() 返回从时间“t1”到时间“t2”的秒数。
os.execute() 将字符串传递给操作系统以执行，并返回系统相关的状态代码。
os.exit() 调用 C 函数 exit() 终止主机程序。
os.remove() 删除文档或临时目录中的文件或目录。
os.rename() 重命名文档或临时目录中的文件或目录。