[crtmpserver流媒体]crtmpserver技术配置文件

Configuration file
配置文件

The configuration file is actually a lua script which must contain an object called configuration. 
This will be read by the server and used to fully configure the server. Besides this object called 
configuration you can have functions, include other lua libraries, etc. In the end, you have to
make the configuration object available. The rest of this section will explain the structue of 
configuration object in great detail. But first, let's take an bird-eye view.

配置文件实际上是一个Lua脚本，它包含至少一个configuration的对象，
从而为程序提供灵活的扩展和定制功能。
除了configuration对象外，还可以有函数，Lua库等。

Main structure
主结构

When the server starts, the following sequence of operations is performed:
服务启动时，将按顺序执行下列操作:

1. The configuration file is loaded. Part of the loading process, is the verification.
   If something is wrong with the syntax please read this
   配置文件加载后，首先做的就是对配置文件进行校验，
   如果配置文件有错误，将会有错误提示并停止启动，可进行修改后再启动
2. daemon value is read. The server now will either fork to become daemon
   or continue as is in console mode
   读取 daemon 值，判断服务是以后台方式启动还是以控制台方式启动
3. logAppenders is read. This is where all log appenders are configured and brought up to running state.
   Depending on the collection of your log appenders, you may (not) see further log messages
   读取日志追加器，用来配置日志记录并启动到运行状态，
   依据日志追加器，可以看到更多的日志信息
4. applications is taken into consideration. Up until now, the server doesn't do much.
   After this stage completes, all the applications are fully functional and the server is online and ready to do stuff
   最后的应用加载，只到这一步完成后，服务和应用才在线，并准备就绪。

日志追加器
logAppenders

This section contains a list of log appenders. The entire collection of appenders listed in this section
is loaded inside the logger at config-time. All log messages will be than passed to all this log appenders.
Depending on the log level, an appender may (not) log the message. “Logging” a message means “saving”
it on the specified “media” (in the example below we have a console appender and a file).
这部分包含了一个日志追加器的列表。
整个日志追加器的添加是在加载时配置，
依据日志级别，追加器可以选择是否有日志消息输出到指定目的处；
logAppenders=
{
  {
    name="console appender",
    type="coloredConsole",
    level=6
  },
  {
    name="file appender",
    type="file",
    level=6,
    fileName="/tmp/crtmpserver.log"
  }
},

Observation: When daemon mode is set to true, all console appenders will be ignored.
(Read the explanation for daemon setting here)
注意:
当使用后台模式时，所有的控制台追加消息将会被忽略。

应用
applications

This section is where all the applications inside the server are placed.
It holds the attributes of each application that the server will use to launch them.
Each application may have specific attributes that it requires to execute its own functionality.
这部分用来配置各种应用，并设置这些应用的属性；
每个应用的属性都对应了这个应用的指定功能；
applications=
{
  rootDirectory="applications",
  {
    -- settings for application 1
    -- content removed for clarity
  },
  {
    -- settings for application 2
    -- content removed for clarity
  },
  {
    -- settings for application 3
    -- content removed for clarity
  }
}

Following the rootDirectory, there is a collection of applications. Each application has
its properties contained in an object. See details below
rootDirectory 之后，是应用的集合；每个应用都定义了一个有特定属性的对象；
细节如下所示；