RU/Resource:Voice - Revision history

Vincent at 18:40, 18 May 2012

2012-05-18T18:40:38Z

← Older revision		Revision as of 18:40, 18 May 2012
Line 8:		Line 8:
	= Концепция =		= Концепция =
	Ресурс Voice предоставляет возможность распределять игроков по '''каналам'''. Канал - способ контроля над теми, с кем вы можете разговаривать и кого можете слышать. Есть три основных типа каналов:		Ресурс Voice предоставляет возможность распределять игроков по '''каналам'''. Канал - способ контроля над теми, с кем вы можете разговаривать и кого можете слышать. Есть три основных типа каналов:
	* '''Скриптовый канал:''' Канал, установленный функцией [[Resource:Voice#~~getPlayerChannel~~\|setPlayerChannel]], он имеет формат номера. Игроки канала ''1'' не могут слышать игроков из канала ''2''.		* '''Скриптовый канал:''' Канал, установленный функцией [[RU/Resource:Voice#setPlayerChannel\|setPlayerChannel]], он имеет формат номера. Игроки канала ''1'' не могут слышать игроков из канала ''2''.

	* '''Командный канал:''' У скриптов нет доступа к этому типа каналов, но он во многом похож на скриптовый канал. Этот тип канала автоматически задается в зависимости от настройки [[Resource:Voice#~~Team_autoassignment~~\|распределения по командам]]. Если игрок находится в команде, [[Resource:Voice#getPlayerChannel\|getPlayerChannel]] будет возвращать элемент [[team\|команды]]. Игроки из одного командного канала не могут слышать игроков из других командных каналов. К тому же, игроки из командного канала не могут слышать и игроков из ''скриптовых каналов''.		* '''Командный канал:''' У скриптов нет доступа к этому типа каналов, но он во многом похож на скриптовый канал. Этот тип канала автоматически задается в зависимости от настройки [[RU/Resource:Voice#Автораспределение по командам\|распределения по командам]]. Если игрок находится в команде, [[RU/Resource:Voice#getPlayerChannel\|getPlayerChannel]] будет возвращать элемент [[team\|команды]]. Игроки из одного командного канала не могут слышать игроков из других командных каналов. К тому же, игроки из командного канала не могут слышать и игроков из ''скриптовых каналов''.

	* '''"Root" (корневой) канал:''' Игроки помещаются в этот канал по умолчанию. Этот канал связан с концепцией элемента [[getRootElement\|root]], и [[Resource:Voice#getPlayerChannel\|getPlayerChannel]] вернет root (корневой) элемент. Когда игрок в канале root, его слышат '''все''' игроки сервера. Как бы то ни было, он не сможет слышать игроков ни из ''командного канала'', ни из ''скриптового канала''.		* '''"Root" (корневой) канал:''' Игроки помещаются в этот канал по умолчанию. Этот канал связан с концепцией элемента [[getRootElement\|root]], и [[RU/Resource:Voice#getPlayerChannel\|getPlayerChannel]] вернет root (корневой) элемент. Когда игрок в канале root, его слышат '''все''' игроки сервера. Как бы то ни было, он не сможет слышать игроков ни из ''командного канала'', ни из ''скриптового канала''.

Vincent: подчистил

2012-05-18T17:41:42Z

подчистил

← Older revision		Revision as of 17:41, 18 May 2012
Line 2:		Line 2:
	Внедрение поддержки голосовой связи в версии 1.1 произошло вместе с базовым, но гибким скриптовым интерфейсом для него.		Внедрение поддержки голосовой связи в версии 1.1 произошло вместе с базовым, но гибким скриптовым интерфейсом для него.

	Цель ресурса '''Voice''' - предоставить типичный интерфейс, основанный на базовом внутреннем скриптинге MTA, для доступа к простому функционалу, который пользователь ожидает от голосового чата, включая возможность создавать разные каналы (в т.ч. для команд) и заглушать голоса других игроков.		Цель ресурса '''Voice''' - предоставить типичный интерфейс, основанный на базовом внутреннем скриптинге MTA, для доступа к простому функционалу, который пользователь ожидает от голосового чата, включая возможность создавать разные каналы (в т.ч. для команд) и заглушать (голоса) других игроков.

	На данный момент ресурс '''Voice''' не имеет GUI-интерфейса для заглушения ~~голосов~~ других игроков на клиентской стороне, но это будет реализовано позже.		На данный момент ресурс '''Voice''' не имеет GUI-интерфейса для заглушения других игроков на клиентской стороне, но это будет реализовано позже.

	= Концепция =		= Концепция =
	Ресурс Voice предоставляет возможность распределять игроков по '''каналам'''. Канал - способ контроля над теми, с кем вы можете разговаривать и кого можете слышать. Есть три основных типа каналов:		Ресурс Voice предоставляет возможность распределять игроков по '''каналам'''. Канал - способ контроля над теми, с кем вы можете разговаривать и кого можете слышать. Есть три основных типа каналов:
	* '''Скриптовый канал:''' Канал, установленный функцией [[Resource:Voice#getPlayerChannel\|setPlayerChannel]], он имеет формат номера. Игроки канала ''1'' не могут слышать ~~голоса~~ игроков из канала ''2''.		* '''Скриптовый канал:''' Канал, установленный функцией [[Resource:Voice#getPlayerChannel\|setPlayerChannel]], он имеет формат номера. Игроки канала ''1'' не могут слышать игроков из канала ''2''.

	* '''Командный канал:''' У скриптов нет доступа к этому типа каналов, но он во многом похож на скриптовый канал. Этот тип канала автоматически задается в зависимости от настройки [[Resource:Voice#Team_autoassignment\|распределения по командам]]. Если игрок находится в команде, [[Resource:Voice#getPlayerChannel\|getPlayerChannel]] будет возвращать элемент [[team\|команды]]. Игроки из одного командного канала не могут слышать ~~голоса~~ игроков из других командных каналов. К тому же, игроки из командного канала не могут слышать и ~~голоса~~ игроков из ''скриптовых каналов''.		* '''Командный канал:''' У скриптов нет доступа к этому типа каналов, но он во многом похож на скриптовый канал. Этот тип канала автоматически задается в зависимости от настройки [[Resource:Voice#Team_autoassignment\|распределения по командам]]. Если игрок находится в команде, [[Resource:Voice#getPlayerChannel\|getPlayerChannel]] будет возвращать элемент [[team\|команды]]. Игроки из одного командного канала не могут слышать игроков из других командных каналов. К тому же, игроки из командного канала не могут слышать и игроков из ''скриптовых каналов''.

	* '''"Root" (корневой) канал:''' Игроки помещаются в этот канал по умолчанию. Этот канал связан с концепцией элемента [[getRootElement\|root]], и [[Resource:Voice#getPlayerChannel\|getPlayerChannel]] вернет root (корневой) элемент. Когда игрок в канале root, его слышат '''все''' игроки сервера. Как бы то ни было, он не сможет слышать ~~голоса~~ игроков ни из ''командного канала'', ни из ''скриптового канала''.		* '''"Root" (корневой) канал:''' Игроки помещаются в этот канал по умолчанию. Этот канал связан с концепцией элемента [[getRootElement\|root]], и [[Resource:Voice#getPlayerChannel\|getPlayerChannel]] вернет root (корневой) элемент. Когда игрок в канале root, его слышат '''все''' игроки сервера. Как бы то ни было, он не сможет слышать игроков ни из ''командного канала'', ни из ''скриптового канала''.

Vincent at 17:40, 18 May 2012

2012-05-18T17:40:26Z

Show changes

Vincent: Created page with "{{RU/Resource page}} Внедрение поддержки голосовой связи в версии 1.1 идет вместе с базовым, но гибким скрип..."

2012-05-18T17:25:47Z

Created page with "{{RU/Resource page}} Внедрение поддержки голосовой связи в версии 1.1 идет вместе с базовым, но гибким скрип..."

New page

{{RU/Resource page}}
Внедрение поддержки голосовой связи в версии 1.1 идет вместе с базовым, но гибким скриптовым интерфейсом для него.

Цель ресурса '''Voice''' - предоставить типичный интерфейс, основанный на базовом внутреннем скриптинге MTA, для доступа к простому функционалу, который пользователь ожидает от голосового чата, включая возможность создавать разные каналы (в т.ч. для команд) и "глушить" игроков.

Ресурс '''Voice''' на данный момент не обладает GUI-интерфейса для заглушения других игроков на клиентской стороне, но это будет реализовано.

= Концепция =
Ресурс Voice предоставляет возможность распределять по '''каналам'''. Канал - способ контроля над тем, с кем вы можете разговаривать и кого можете слышать. Есть три основных типа каналов:
* '''Скриптовый канал:''' Канал, установленный функцией [[Resource:Voice#getPlayerChannel|setPlayerChannel]], он имеет формат номера. Игроки канала ''1'' не моугт слышать игроков из канала ''2''.

* '''Командный канал:''' У скриптов нет доступа к этому типа каналов, но он достаточно похож на скриптовый канал. Этот тип канала автоматически задается в зависимости от настройки [[Resource:Voice#Team_autoassignment|распределения по командам]] setting. Когда игроки находятся в команде, [[Resource:Voice#getPlayerChannel|getPlayerChannel]] будет возвращать элемент [[team|команды]]. Игроки одного командного канала не могут слышать игроков другого командного канала. В равной степени, игроки из командного канала не могут слышать игркоов из ''скриптового канала''.

* '''"Root" (корневой) канал:''' Игроки помещаются в этот канал по умолчанию. Этот канал связан с концепцией элемента [[getRootElement|root]], и [[Resource:Voice#getPlayerChannel|getPlayerChannel]] вернет root (корневой) элемент. Когда игрок в root канале, его слышат '''все''' игроки сервера. Как бы то ни было, он не сможет слышать игроков ни из ''командного канала'', ни из ''скриптового канала''.

= Настройки =
Все настройки могут изменены через MTA'шыне функции set(), изменение meta.xml ресурса или изменение settings.xml.

===Иконки чата===
* '''Имя настройки:''' ''show_chat_icon''
* '''Описание:''' Булевая переменная, которая позволяет вам включать или выключать иконку голосового чата, возникающую над игроком, когда он говорит.
* '''XML-образец:''' <syntaxhighlight lang="xml"><setting name="show_chat_icon" value="[false]"/></syntaxhighlight>

===Автораспределение по командам===
* '''Имя настройки:''' ''autoassign_to_teams''
* '''Описание:''' Булевая переменная, которая позволяет вам включать или выключать автораспределение игроков по каналом их команд ресурсом voice.
* '''XML-образец:''' <syntaxhighlight lang="xml"><setting name="autoassign_to_teams" value="[false]"/></syntaxhighlight>

=Клиентский функции скриптинга=
Все указанные функции скриптинга - '''клиентские''' и затрагивают только '''local player''' (локального игрока). Все функции должны вызываться с использованием функции [[call]].

===isPlayerMuted===
Эта функция позволяет определять, заглушен ли удаленный игрок у локального игрока. Другими словами, могу ли я слышать этого самого удаленного игрока?
<syntaxhighlight lang="lua">
bool exports.voice:isPlayerMuted ( player playerToCheck )
</syntaxhighlight>
* '''playerToCheck:''' Игрок, слышимость которого вы хотите проверить
Возвращает булевую переменную - '''true'' если заглушен, иначе '''false'''.

===setPlayerMuted===
Эта функция позволяет вам заглушить удаленного игрока у локального игрока. Проще говоря, я могу заглушить у себя этого игрока, когда захочу.
<syntaxhighlight lang="lua">
bool exports.voice:setPlayerMuted ( player playerToMute, bool muted )
</syntaxhighlight>
* '''playerToMute:''' Игрок, которого вы хотите заглушить или разглушить
* '''muted :''' Булевая переменная, отвечающая за то, будет ли игрок заглушен или разглушен, где '''true''' для заглушения, '''false''' - наоборот.
Воавращает '''true''', если операция прошла успешно, иначе - '''false'''.

=Серверные функции скриптинга=
Все указанные функции скриптинга - '''серверные''' и затрагивают всех игроков без исключения. Все функции должны вызываться с использованием функции [[call]].

===isPlayerMuted===
Функция позволяет вам проверять игрока на заглушенность для всего сервера.
<syntaxhighlight lang="lua">
bool exports.voice:isPlayerMuted ( player playerToCheck )
</syntaxhighlight>
* '''playerToCheck:''' Игрок, заглушенность которого вы хотите проверить
Возвращает '''true'' если он заглушен, иначе - '''false'''

===setPlayerMuted===
Эта функция позволяет заглушить игрока для всех на сервере.
<syntaxhighlight lang="lua">
bool exports.voice:setPlayerMuted ( player playerToMute, bool muted )
</syntaxhighlight>
* '''playerToMute:''' Игрок, которого вы хотите заглушить или разглушить
* '''muted :''' Булевая переменная, отвечающая за то, будет ли игрок заглушен или разглушен. '''true''' для заглушения, '''false''' для разглушения.
Возвращает '''true''', если операция прошла успешно, иначе - '''false'''.

===getPlayerMutedByList===
Эта функция позволяет вам заправшивать список всех игроков, кто заглушил указанного игрока.
<syntaxhighlight lang="lua">
table exports.voice:getPlayerMutedByList( player playerToCheck )
</syntaxhighlight>
* '''playerToCheck:''' Игрок, на заглушенность которого вы хотите проверить игроков сервера
Возвращает таблицу игрков, заглушивших указанного игрока.

===getPlayerChannel===
Эта функция позволяет вам запросить, в каком канале голосового чата находится игрок.
<syntaxhighlight lang="lua">
int/element exports.voice:getPlayerChannel ( player playerToCheck )
</syntaxhighlight>
* '''playerToCheck:''' Игрок, канал нахождения которого вы хотите запросить
Возвращает целове число - ID канала, в котором он находится, элемент [[team|команды]], если игрок находится в ее канала или [[getRootElement|root]] (корневой) элемент, если канал не указан.

===setPlayerChannel===
TЭта функция позволяет вам переместить указанного игрока в другой канал.
<syntaxhighlight lang="lua">
bool exports.voice:setPlayerChannel ( player playerToCheck, [ int channelID ] )
</syntaxhighlight>
* '''playerToCheck:''' Игрок, которого вы хотите переместить
* '''channelID :''' ''Опционально:'' ID канала, в который вы хотите переместить игрока. Неуказание данного аргумента позволит ресурсу Voice автоматичсеки распорядиться игроком (напр. авто-распределить в канал команды).
Возвращает '''true''', если операция успешна, иначе - '''false'''.

===getPlayersInChannel===
Эта функция позволяет вам запросить лист игроков, находищихся в определенном канале.
<syntaxhighlight lang="lua">
table exports.voice:getPlayersInChannel ( int channelID )
</syntaxhighlight>
* '''channelID :''' ID канала, лист игроков, находищихся в котором, вы хотите запросить.
Возвращает таблицу игроков, находящихся в указанном канале.

===getNextEmptyChannel===
Эта функция позволяет вам получить ID следующего полностью пустого канала, позволяя с легкостью создавать новые
<syntaxhighlight lang="lua">
int getNextEmptyChannel ( )
</syntaxhighlight>
Возвращает целое число - номер первого канала, который оказался полностью пустым.

[[en:Resource:Voice]]