Corona 环境 - Solar2D 游戏引擎

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

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

方法概要

方法
修饰符和类型	方法和说明
`static void`	`addRuntimeListener(CoronaRuntimeListener listener)` 添加一个侦听器，用于从 `CoronaRuntime` 接收事件。
`static android.content.Context`	`getApplicationContext()` 提供对此应用程序上下文的轻松访问。
`static String`	`getApplicationName()` 提供对显示给最终用户的应用程序名称的轻松访问。
`static File`	`getCachesDirectory(android.content.Context context)` 获取 Corona 缓存目录的路径。
`static CoronaActivity`	`getCoronaActivity()` 获取对当前活动的 `CoronaActivity` 的引用。
`static File`	`getDocumentsDirectory(android.content.Context context)` 获取 Corona 文档目录的路径。
`static JavaFunction`	`getLuaErrorHandler()` 获取提供给 `CoronaEnvironment.setLuaErrorHandler()` 方法的自定义 Lua 错误处理程序。
`static File`	`getTemporaryDirectory(android.content.Context context)` 获取 Corona 临时目录的路径。
`static void`	`removeRuntimeListener(CoronaRuntimeListener listener)` 移除通过 `addRuntimeListener()` 方法添加的给定侦听器。
`static void`	`setLuaErrorHandler(JavaFunction handler)` 为 Lua 错误（例如语法错误或运行时错误）设置自定义处理程序。
`static 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 当前在后台挂起，则此方法会将其置于前台。
    不要在 CORONACARDS FOR ANDROID 项目中使用此 API！CoronaCards for Android 中没有 CoronaActivity，因此调用此 API 将导致您的应用**崩溃**！
    
    参数
    context - 通过意图显示 CoronaActivity 所需的上下文派生对象。不能为空。
  - getCoronaActivity
```
public static CoronaActivity getCoronaActivity()
```
    获取对当前活动的 CoronaActivity 的引用。
    
    返回
    返回对当前活动的 CoronaActivity 对象的引用。如果从未创建 CoronaActivity、已将其销毁或我们正在使用 CoronaCards for Android，则返回 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