• Игролог
• Игры
• Об авторе

Player.IO. Основы или первая онлайн игра

Если вы вдруг не знакомы с историей программирования и соглашений, то Hello World — это просто программа, которая выводит текст «Hello World». Таким образом, это считается эффективным средством вводного обучения. Наш «Hello World!» — это программа, которая будет отправлять сообщение на сервер, а сервер будет отвечать «Hello World!». Мы будем следить за этим сообщением и на этом простом примере узнаем необходимые нам основы об общении нашего приложения с сервером.

Если вы не хотите повторять все описанные шаги самостоятельно, то вы сразу можете загрузить готовый пример — CS4, *.zip, 1,5мб

Забегая вперед, хочу вам сказать, что если вам приходилось имплементировать в ваши игры, например API MochiMedia, то в данном случае работа с сервером Player.IO ни чуть не сложнее.

Давайте создадим новый Flash проект и добавим базовый класс, который будет точкой входа в наше приложение, назовем его HelloWorld.as и свяжем с HelloWorld.fla.

В первую очередь мы рассмотрим код, который нам понадобится на стороне клиента, то есть во Flash. Чтобы работать с сервером, нам необходимо подключить Player.IO API —это те классы, которые будут делать всю скучную техническую работу, реализуя наше общение с сервером.

import playerio.* // Подключаем PlayerIO API

Теперь добавим новую публичную переменную, в которой у нас будет храниться наш уникальный идентификатор игры. �?дентификатор игры необходимо получить, создав учетную запись на playerio.com и добавив туда свою игру. Данные добавленной игры могут быть отредактированны или удаленны в любой момент, так что не переживайте о корректности заполнения форм для получения идентификатора игры. В коде идентификатор игры назовем идентификатор так:

public var gameID:String = "вставьте сюда свой идентификатор";

Далее в конструкторе нашего HelloWorld.as нам следует вызвать метод PlayerIO.connect() для подключения:

PlayerIO.connect(
  stage, // Указатель на stage
  gameID, // �?дентификатор нашей игры
  "public", // Тип соединения, по умолчанию публичное
  "GuestUser", // �?мя пользователя в игре, который подключается
  "", // Авторизация пользователя. Может быть пустой, если авторизация не нужна.
  null, // Партнер для внутреигровых платежей (дополнительный сервис)
  handleConnect, // Указатель на метод, который будет вызван при успешном подключении
  handleError // Указатель на метод, который будет вызван, если подключение по какой-либо причине не удастся.
);

Надеюсь в выше представленном коде достаточно комментариев, чтобы понять его суть, поэтому мы сразу перейдем к методу обработчику успешного подключения:

private function handleConnect(client:Client):void
{ 
  trace("Connected to server")
  
  // Устанавливаем подключение к локальному серверу для отладки
  client.multiplayer.developmentServer = "localhost:8184";
            
  // Создаем или подключаемся к игровой комнате "test"
  client.multiplayer.createJoinRoom(
    "test", // �?дентификатор комнаты. Если установить null, то идентификатор будет присвоен случайный
    "MyCode", // Тип игры запускаемый на сервере (привязка к серверному коду)
    true, // Должна ли комната видима в списке комнат?
    {}, // Какие-либо данные. Эти данные будут возвращены в список комнат. Значения могут быть изменены на сервере.
    {}, // Какие-либо данные пользователя.
    handleJoin, // Указатель на метод, который будет вызван при успешном подключении к комнате.
    handleError // Указатель на метод, который будет вызван в случае ошибки подключения
  ); 
}

В этом методе мы первым делом сообщаем, что подключение успешно произведено. Второй строкой мы определяем, что подключение должно быть произведено к отладочному локальному серверу — этот сервер будет доступен, когда вы запустите компиляцию серверного кода в Visual Studio. Чтобы подключиться к онлайн серверу, просто закомментируйте или удалите эту строку. Но, помните, что для успешного подключения к онлайн-серверу вам изначально нужно будет загрузить туда библиотеку с вашим кодом. Далее в коде мы вызываем еще один интересный метод, который создает или подключается к уже существующей игровой комнате.

Тут хотелось бы немного отвлечься от кода и рассказать, что скрывается под понятием «игровая комната». �?гровая комната — это некая сущность, в которой собираются игроки перед запуском игры, либо игровая комната может быть сущностью уже созданного игрового процесса (мира), в который сразу может включиться новый игрок. Каким образом вы используете игровые комнаты — зависит напрямую от геймплея. В общем все игроки, которые как-то могут взаимодействовать друг с другом, должны быть в одной игровой комнате. Если вы играли в многопользовательские игры, то наверное ни раз видели список созданных игр, в которые можно включиться по ходу игры или непосредственно перед запуском карты. Фактически такие списки — это и есть списки игровых комнат, войдя в такую комнату вы можете пообщаться с другими игроками, которые ожидают запуска игры, и остаться там до начала игры.

В данном примере мы подключаемся к игровой комнате «test», если такой комнаты нет еще на сервере, то она будет создана, и если другие игроки будут подключаться или пытаться создать комнату с таким же именем, то вы окажетесь вместе с ними. Следующий параметр указывает какой серверный код использовать — необходимость этого параметра будет ясна позже. Потом мы указываем будет ли видна наша игровая комната в списке комнат, а так же можем передать какую-либо информацию о созданной комнате и о пользователе в частности. В конце традиционно идут указатели на методы, которые обрабатывают успешное подключение и ошибку подключения соотвественно.

Теперь посмотрим на метод обработчик успешного подключения:

private function handleJoin(connection:Connection):void
{
  // Отправляет "Hello" на сервер 
  connection.send("Hello World");

  // Слушает ответ сервера на сообщение "Hello World" и выводит его в trace
   connection.addMessageHandler("Hello World", function(m:Message){
     trace(m.type);           
  });
}

В данном методе первой строкой мы отправляем простое сообщение на сервер «Hello World». А второй строкой мы подписываемся на аналогичное сообщение от сервера, и при подписке указываем метод или указатель на метод, который будет вызван при получении указанного сообщения. В нашем случае мы просто выводим полученное сообщение в окно output.

Как вы можете видеть, когда соединение успешно установлено, передавать и получать сообщения очень легко. Для этого обычно требуется только один вызов connection.send(). Осталось только взглянуть на обработчик ошибок и можно будет перейти к коду сервера:

private function handleError(error:PlayerIOError):void
{
  trace(">" + error);
}

Серверный код

Flash клиент готов и теперь можно посмотреть как устроен наш сервер, чтобы обработать и вернуть наше сообщение. Основная часть кода на стороне сервера настолько проста, что может показаться даже скучной. В данном примере на сервере у нас всего одна строка:

player.Send("Hello World");

Но давайте посмотрим на весь код сервера:

using System;
using System.Collections.Generic;
using System.Text;
using System.Collections;
using PlayerIO.GameLibrary;
using System.Drawing;
 
namespace MyGame {
  public class Player : BasePlayer {
    public string Name;
  }

  public class GameCode : Game {
    public override void GameStarted() {}
    public override void UserJoined(Player player) {}
    public override void UserLeft(Player player) {}

    public override void GotMessage(Player player, Message message) {
      player.Send("Hello World");
    }
  }
}

Здесь мы используем только один метод GotMessage(), в котором записана наша строка. Метод GotMessage() выполняется на сервере всякий раз, когда сервер получает сообщение от игрока. В этом методе мы имеем два аргумента — это указатель на игрока, от которого пришло сообщение и само сообщение.

Строка player.Send() делает фактически тоже самое, что и connection.send() во Flash. Только мы посылаем сообщение «Hello World» от сервера к указанному игроку.

Если мы хотим отправить сообщения всем игрокам, а не конкретному игроку, то нам вместо player.Send() следует использовать метод Broadcast(), который разошлет указанное сообщение всем игрокам в текущей игровой комнате.

Сообщения имеют важное значение в работе нашей игры. Давайте теперь еще немного углубимся в механизм их работы.

Сообщения

Любое сообщение, отправляемое нами на сервер или с сервера, состоит, как правило, из двух частей. Первая часть сообщения — это его уникальное имя, или еще можно сказать идентификатор, по которому мы можем определить, о чем это сообщение. Например, в нашем примере идентификатор сообщения «Hello World». Если бы у нас была полноценная игра, то мы могли бы использовать более емкий идентификатор, например «move» или «attack».

Вторая часть сообщения является фактическими данными. Каждое сообщение может содержать произвольное количество данных. Эти данные, как правило, являются цифрами, текстами и любой другой информацией. Визуальное представление сообщения может выглядить так:

Какие-либо данные к сообщениям прикрепляются при необходимости. Например, в нашем примере нам не нужны какие-либо данные и одного идентификатора сообщения достаточно, чтобы предпринять какое-то действие при его получении, использовав его как команду.

Но все же в большинстве случаев мы будем отправлять сообщения с данными. Например, если вы хотите отправить сообщение о том, что вы двигаетесь к x=200 и y=300, то сообщение может выглядить следующим образом:

Код отправки такого сообщения такой же простой, как и для наших предыдущих сообщений. Просто добавьте данные, как дополнительные аргументы при вызове метода:

connection.send("move", 200, 300);

Получение и чтение сообщений

�?звлечение данных из полученных сообщений ни чуть не сложнее, чем их отправка. �?звлечение выглядит одинаково для сервера и клиента. Основные отличия являются только в разнице типов данных, которые используются в AS3 и C#. Так же имеются некоторые различия в синтаксисе, поэтому я рекомендую вам обратиться к документации C#.

Давайте предположим, что мы можем отправить три таких сообщения:

Эти сообщения сообщают, что мы двигаемся, получаем очки и были убиты. Это будет наш псевдо код для их получения и обработки:

connection.addMessageHandler("move", gotMove);
connection.addMessageHandler("points", getPoints);
connection.addMessageHandler("killed", gotKilled);

function gotMove(m:Message){
  x = m.getInt(0);
  y = m.getInt(1);
}
 
function gotPoints(m:Message){
  points += m.getInt(0);
}
 
function gotKilled(m:Message){
  // Обработчик смерти
}

В первых трех строках мы добавляем слушателей на сообщения. Они будут ожидать получения соотвествующих сообщений и вызывать указанные методы при их получении. То есть метод gotMove() будет вызван, когда мы получим сообщение «move» от сервера. Данные пришедшие с сообщением похожи на массив значений, но для обращения к ним мы используем метод get[dataType](index). Например, чтобы получить строку из нулевой ячейки, мы должны вызвать getString(0), или если нужна цифра из второй ячейки, то getInt(1).

Вот собственно и все основы. Теперь мы знаем как может выглядеть код на клиенте и на сервере, мы научились отправлять и получать сообщения, а так же извлекать из них данные. Но не спешите радоваться и сладостно потягиваться в кресле, подумывая о том, какие крутые игры вы сейчас сделаете! Не стоит недооценивать сеть — это жестокая и безжалостная штука с кучей подводных камней и ловушек, особенно для новичков.

Конечно, самые большие сложности возникают в играх, протекающих в реальном времени, и все эти сложности в основном связанны с задержками, возникающими в сети из-за медленного соеденения с �?нтернет у одного или нескольких пользователей. Но прежде, чем мы поговорим об онлайн играх в реальном времени, мы рассмотрим более простые игры с пошаговым геймплеем.

Это вольный перевод статьи «Building Flash Multiplayer Games — Game Basics».

Содержание

1. Как создать онлайн игру? Анонс
2. Player.IO. Введение
3. Player.IO. Основы или первая онлайн игра
4. Player.IO. Пошаговые игры
5. Player.IO. Сетевые архитектуры
6. Player.IO. Безопасность в онлайн играх
7. Player.IO. Пример пошаговой игры
8. Player.IO. Онлайн игры в реальном времени
9. Player.IO. Синхронизация игроков
10. Player.IO. �?нтерполяция или удивительный мир обмана
11. Player.IO. Решение проблемы задержек
12. Player.IO. Советы и рекомендации