четверг, января 31, 2008

SmartFoxServer. Конфигурация зон.

Конфигурация зон располагается в контейнерном теге <Zones/>. Каждая зона представлена тегом <Zone/> в Config.xml Этот файл располагается в директории сервера (для Windows это "C:\Program Files\SmartFoxServerPRO_1.6.0\Server\").

Параметры зоны:
name - имя зоны
uCountUpdate - Вкл/выкл (true/false) посылку сервером сообщений о количестве пользователей. Это необходимо для мониторинга в реальном времени статуса комнат.
ВАЖНО: Необходимо определиться - использовать ли глобальное обновление статуса комнат или нет. К примеру, если в списке комнат необходимо отображать текущее количество пользователей и обновлять его в реальном времени, этот параметр необходим. Если же требуется сократить объем трафика, то лучше обновление производить по запросу (кнопка "Обновить"), а этот параметр отключить. Для игровых комнат по умолчанию равен "false".
maxUsers - максимальное число пользователей, которым доступна зона.
maxRooms - максимальное число комнат в зоне, которое могут создать пользователи. Без ограничения равно -1.
maxRoomsPerUser - максимальное число комнат, которое может создать пользователь за один сеанс. По умолчанию равно 5.
emptyNames - Вкл/выкл (true/false) возможность анонимного входа. Если параметр включен, и пользователь входит анонимно, ему присваивается имя "Guest_"+номер.
roomListVars - Если "true", то при запросе списка комнат сервер будет выдавать все переменные каждой из комнат.
BuddyList - список друзей. Устаревший параметр - не будем его пользовать. В новых версиях список задается во вложенном теге <BuddyList/> .

Зона может содержать следующие теги:
<Moderators/> - список модераторов. Это контейнер, содержащий список тегов <Mod/>, с двумя параметрами: name и pwd - имя и пароль модератора.

<DisabledSysEvents/>, список событий сервера, которые необходимо блокировать. Это контейнер, содержащий список тегов <event/> заключающих в себя название события.

<DisabledSysActions/>, список действий сервера, которые необходимо блокировать. Это контейнер, содержащий список тегов <action/> заключающих в себя название действия.

<UserNameAvoidChars/> - запрещенные символы в именах пользователей. Указываются в виде строки, заключенной в CDATA.
<RoomNameAvoidChars/> - запрещенные символы в именах комнат. Указываются в виде строки, заключенной в CDATA.
<MaxUserNamesLen/> - максимальное число символов в именах пользователей.
<MaxRoomNamesLen/> - максимальное число символов в именах комнат.

<AutoReloadExtensions/> - разрешает немедленное обновление серверных скриптов после их модификации.

Ниже рассмотрены другие теги, которые включены в зону.

Параметры списка друзей
Тег <BuddyList/> определяет конфигурацию списка друзей.
Параметр active включает активность списка.

Базовые параметры:
<mode/> - режим работы: basic (поддерживает совместимость со старыми версиями) и advanced (позволяет использовать новые возможности).
<size/> - максимальное число пользователей.
<maxBuddyVars/> - максимальное число переменных на каждого друга.

Новые параметры:
<addBuddyPermission/>, <permissionTimeOut/>, <mutualAddBuddy/>, <mutualRemoveBuddy/> -параметры взаимодействия пользователей в списках друзей.
<offLineBuddyVariables/> позволяет включить режим передачи запросов off-line пользователю с ожиданием, когда он выйдет в on-line.
<persisterClass/> - позволяет указать имя другого класса для обработки списков друзей.

Параметры конфигурации комнат.
name - имя комнаты
isPrivate - требует пароль для входа
pwd - пароль для входа в комнату
isGame - включает дополнительные функции, необходимые для игрового сервера.
limbo - Специальная комната, которая может содержать тысячи не взаимодействующих посетителей. Такие комнаты не генерируют определенных событий, не позволяют рассылать массовые сообщения и т.п.
maxUsers - максимум пользователей, которые могут одновременно присоединиться к комнате. Рекомендуется от 2 до 50 пользователей.
maxSpectators - максимум наблюдателей.
autoJoin - по команде клиента autoJoin(), пользователь по-умолчанию войдет в эту комнату.
uCountUpdate - аналогично одноименному параметру зоны. Для игр лучше установить "false".

Переменные по умолчанию
<Vars/> содержит список тегов <Var/>, в который контейнерно заключается значение переменной. Каждый из тегов содержит параметры переменной:
name - имя переменной.
type - тип переменной ( s = string, n = number, b = boolean ).
private - если true, переменная является приватной.

Серверные скрипты (или расширения)
<Extensions/> содержит список тегов <extension/>.
Каждый из тегов содержит параметры скрипта:
name - имя скрипта.
className - имя файла скрипта.
type - "script" для ActionScript, "python" для Python, "java" для Java.

Другие параметры.
Были замечены другие параметры.

Для Zone:
customLogin

Для Room
isTemp

Их значение выясним позже.

Комментариев нет: