Corona 环境 - Solar2D 游戏引擎

java.lang.Object
- com.ansca.corona.CoronaEnvironment

```
public final class CoronaEnvironment
extends Object
```
提供用于启动和访问 CoronaActivity 的简单方法，以及设置用于接收来自 CoronaRuntime 的事件的侦听器。
此类中的所有方法都是线程安全的，可以从任何线程调用。
您无法创建此类的实例。访问是通过静态方法提供的。

方法概要

方法
修饰符和类型	方法和说明
`静态 void`	`addRuntimeListener(CoronaRuntimeListener listener)` 添加一个侦听器，用于接收来自 `CoronaRuntime` 的事件。
`静态 android.content.Context`	`getApplicationContext()` 提供对此应用程序上下文的轻松访问。
`静态 String`	`getApplicationName()` 提供对显示给最终用户的应用程序名称的轻松访问。
`静态 File`	`getCachesDirectory(android.content.Context context)` 获取 Corona 缓存目录的路径。
`静态 CoronaActivity`	`getCoronaActivity()` 获取对当前活动的 `CoronaActivity` 的引用。
`静态 File`	`getDocumentsDirectory(android.content.Context context)` 获取 Corona 文档目录的路径。
`静态 JavaFunction`	`getLuaErrorHandler()` 获取提供给 `CoronaEnvironment.setLuaErrorHandler()` 方法的自定义 Lua 错误处理程序。
`静态 File`	`getTemporaryDirectory(android.content.Context context)` 获取 Corona 临时目录的路径。
`静态 void`	`removeRuntimeListener(CoronaRuntimeListener listener)` 删除通过 `addRuntimeListener()` 方法添加的给定侦听器。
`静态 void`	`setLuaErrorHandler(JavaFunction handler)` 设置 Lua 错误（例如语法错误或运行时错误）的自定义处理程序。
`静态 void`	`showCoronaActivity(android.content.Context context)` 在屏幕上显示 `CoronaActivity` 窗口。

从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 方法详细资料
  - getDocumentsDirectory
```
public static File getDocumentsDirectory(android.content.Context context)
```
    获取 Corona 文档目录的路径。
    这是 Lua 属性 "system.DocumentsDirectory" 映射到的目录。
    此目录位于内部存储中。
    
    参数
    context - 访问此应用程序目录所需的上下文。不能为空。
    
    返回
    返回设置为指定目录的 File 对象。
  - getTemporaryDirectory
```
public static File getTemporaryDirectory(android.content.Context context)
```
    获取 Corona 临时目录的路径。
    这是 Lua 属性 "system.TemporaryDirectory" 映射到的目录。
    此目录位于内部存储中。如果内部存储空间不足，操作系统将自动删除其文件。
    
    参数
    context - 访问此应用程序目录所需的上下文。不能为空。
    
    返回
    返回设置为指定目录的 File 对象。
  - getCachesDirectory
```
public static File getCachesDirectory(android.content.Context context)
```
    获取 Corona 缓存目录的路径。
    这是 Lua 属性 "system.CachesDirectory" 映射到的目录。
    此目录位于内部存储中。如果内部存储空间不足，操作系统将自动删除其文件。
    
    参数
    context - 访问此应用程序目录所需的上下文。不能为空。
    
    返回
    返回设置为指定目录的 File 对象。
  - showCoronaActivity
```
public static void showCoronaActivity(android.content.Context context)
```
    在屏幕上显示 CoronaActivity 窗口。如果 CoronaActivity 当前在后台挂起，则此方法会将其带到前台。
    请勿在适用于 Android 的 CORONACARDS 项目中使用此 API！适用于 Android 的 CoronaCards 中没有 CoronaActivity，因此调用此 API 将导致您的应用**崩溃**！
    
    参数
    context - 通过意图显示 CoronaActivity 所需的上下文派生对象。不能为空。
  - getCoronaActivity
```
public static CoronaActivity getCoronaActivity()
```
    获取对当前活动的 CoronaActivity 的引用。
    
    返回
    返回对当前活动的 CoronaActivity 对象的引用。如果从未创建 CoronaActivity、已被销毁或我们正在使用适用于 Android 的 CoronaCards，则返回 null。
  - getApplicationContext
```
public static android.content.Context getApplicationContext()
```
    提供对此应用程序上下文的轻松访问。
    
    返回
    返回应用程序上下文对象的实例。如果此应用程序尚未完全初始化，则返回 null。
  - getApplicationName
```
public static String getApplicationName()
```
    提供对显示给最终用户的应用程序名称的轻松访问。与 Corona SDK 中的 system.getInfo("appName") 返回的名称相同。
    添加于每日构建版本 2016.2869.
    
    返回
    返回显示给最终用户的应用程序名称。
    如果 CoronaEnvironment.getApplicationContext() 为 null，则返回空的 String。
  - getLuaErrorHandler
```
public static JavaFunction getLuaErrorHandler()
```
    获取提供给 CoronaEnvironment.setLuaErrorHandler() 方法的自定义 Lua 错误处理程序。
    
    返回
    返回对自定义 Lua 错误处理程序的引用。这是一个在 Java 中实现的 Lua 函数。
    如果未设置自定义错误处理程序，则返回 null。在这种情况下，Corona 将使用其默认错误处理。
  - setLuaErrorHandler
```
public static void setLuaErrorHandler(JavaFunction handler)
```
    设置 Lua 错误（例如语法错误或运行时错误）的自定义处理程序。
    
    参数
    handler - 对自定义 Lua 错误处理程序的引用。这是一个在 Java 中实现的 Lua 函数。
    设置为 null 以使用 Corona 的默认错误处理程序。
  - addRuntimeListener
```
public static void addRuntimeListener(CoronaRuntimeListener listener)
```
    添加一个侦听器，用于接收来自 CoronaRuntime 的事件。
    
    参数
    listener - 将接收事件的侦听器。不能为空。
    另请参阅
    CoronaRuntimeListener
  - removeRuntimeListener
```
public static void removeRuntimeListener(CoronaRuntimeListener listener)
```
    删除通过 addRuntimeListener() 方法添加的给定侦听器。
    
    参数
    listener - 要按引用删除的侦听器对象。
    另请参阅
    CoronaRuntimeListener

类 CoronaEnvironment

方法概要

从类 java.lang.Object 继承的方法

方法详细资料

getDocumentsDirectory

getTemporaryDirectory

getCachesDirectory

showCoronaActivity

getCoronaActivity

getApplicationContext

getApplicationName

getLuaErrorHandler

setLuaErrorHandler

addRuntimeListener

removeRuntimeListener