Editing Bombus/HowTo

== Вступление ==
Итак, Вы решили, что необходимо быть всегда и везде на связи, и выбрали для решения данной задачи мобильный [[Jabber]]-[[client|клиент]] [[Bombus]]. Однако, процесс его настройки весьма нетривиален. Того и гляди, запутаешься во всех этих точках доступа, прокси-серверах, транспортах и подписках. В этом небольшом пошаговом руководстве, я попытаюсь по шагам раскрыть все тонкости настройки и использования Bombus. В том числе описывается настройка [[Gateway:ICQ|ICQ-транспорта]].

По большому счету заставить Bombus работать не сложнее, чем установить новую игрушку в [[Cell phone|сотовый телефон]]. И самым сложным этапом будет настройка [[w:GPRS|GPRS]], т.е. доступа в Интернет. Возможно, вы считаете, что у вас уже есть доступ в интернет на мобильном телефоне, хотя вы ничего не настраивали. Если все так и было, то интернет у вас функционирует посредством [[w:WAP|WAP]]. Это крайне расточительно из-за чрезмерной стоимости WAP.

== Требования ==
Итак, для того, чтобы использовать [[Bombus]], Вам понадобится:

* Сотовый телефон, поддерживающий:
** [[w:GPRS|GPRS]]/[[w:EDGE|EDGE]]/[[w:UMTS|UMTS]]/[[w:HSDPA|HSDPA]]
** [[J2ME|Java MIDP]] 2.0 или [[w:Siemens|Siemens]] с MIDP 1.0.
** Закачку Java-мидлетов в память аппарата. Размер исполняего мидлета должен быть больше 200 Кб для использования последних версий [[Bombus]] с поддержкой [[Zlib]] и [[Conference|конференций]].
* SIM-карта Оператора Сотовой Связи, которые предоставляет услугу GPRS-Internet, и, собственно, активированная услуга GPRS-Internet (''не путать с WAP''). На данный момент все операторы сотовой связи предоставляют такую услугу и разница только в расценках на её использование.
* Немного времени, терпения и желания.

Все кроме последнего пункта у вас скорее всего есть, потому что даже бюджетные модели телефонов уже как несколько лет имеют все эти функции. Последний пункт тоже несложно обресть — достаточно немного подумать, сколько денег вы сэкономите, умерив SMS-траффик.

Если у вас нет телефона и вы хотите выбрать оптимальную модель для мобильного общения, то ознакомьтесь со статьей ''[[Bombus:PhoneChoosing|Выбор телефона для Bombus]]''.

== Настройка телефона ==
Для того, чтобы настроить телефон на использование услуги GPRS-Internet, необходимо знать:

* Что нужно сделать, чтобы подключить услугу, если она еще не подключена.
* APN - точка доступа в Интернет.
* Адрес и порт прокси-сервера, если он необходим.
* Имя и пароль для доступа, если необходимо.

Вам необходимо активировать услугу, в соответствии с настройками Оператора заполнить GPRS-профиль, через который Вы будете подключаться к Интернет, выключить и снова включить свой телефон.

Далее я приведу информацию для известных мне Операторов Связи. Данная информация может устаревать со временем, поэтому ориентируйтесь на данные с официальных сайтов, если возникнут какие-то сомнения в процессе настройки.

Производить настройку GPRS требуется не всегда, т.к. телефон изначально может содержать готовые профили для основных сотовых операторов (очевидно, что речь идет о телефонах, которые предназначены для продажи в РФ).

=== МТС ===
Для активации услуги, нужно позвонить по номеру, можно воспользоваться Интернет-Помощником на региональном сайте компании, либо позвонить по номеру: 0022, дождаться приветствия электронного секретаря, далее набать последовательно: 2-2-1-2-1, далее прослушать инструкции секретаря по подтверждению добавления услуги.
* APN: internet.mts.ru
* Имя: mts
* Пароль: mts
* Прокси сервер: не требуется.

=== БиЛайн ===
Для активации услуги можно позвонить по номеру 067409181 либо воспользоваться веб-интерфейсом для управления контрактом. Также можете ознакомиться с [http://www.msk.beeline.ru/services/service.wbp?root_id=84622e7c-9e54-42d2-b146-c435d1793d31&block=connection инструкциями] с сайта Beeline.
* APN: internet.beeline.ru
* Имя: beeline
* Пароль: beeline
* Прокси сервер: не требуется.

===Мегафон===
Активировать услугу можно через USSD-интерфейс, набрав *105*06# и вызов, либо позвонив оператору. Также можете ознакомиться с инструкциями с сайта http://megafon.ru/.

* APN: internet
* Имя: пусто
* Пароль: пусто
* Прокси сервер: не требуется.

=== Теле2 ===
Активация услуги не требуется: она автоматически подключена у всех абонентов компании.
* APN: internet.tele2.ru
* Имя: не указывать
* Пароль: не указывать
* Прокси сервер: не нужен.

== Загрузка Java-мидлета в телефон ==

Теперь, когда телефон настроен на использование GPRS-Интернет, необходимо загрузить Java-мидлет в телефон и установить его как приложение. Это можно сделать следущими путями:

* Через дата-кабель, используя поставляемое с телефоном ПО.
* Через Bluetooth, для моделей, поддерживающих его. 
** '''Требуется''' Bluetooth-адаптер или другой телефон, где есть апплет.
* Через IrDA (инфракрасный порт) для моделей, поддерживающих его, кроме Samsung (исключение: D500). 
** '''Требуется''' IrDA-адаптер или другой телефон, где есть апплет.
* Через GPRS с помощью встроенного браузера телефона. По нашему мнению, самый неудобный способ, но, он может оказаться единственным возможным, если нет других путей, и для некоторых моделей Samsung, Pantech, LG.

Загрузите мидлет с сайта Bombus в свой телефон, и установите его, следуя рекомендациям из инструкции к телефону. Если вознукнут какие-либо проблемы, обращайтесь в [http://forum.JRuDevels.org форум], Вам обязательно помогут.

Если вы хотите использовать для скачивания мидлета телефон, то найдите в нем браузер и укажите путь до файла апплета.
Для того, чтобы узнать это путь, перейдите в соответствующий [http://bombus-im.org/index.php?page=download раздел] сайта и отыщите там jar-файл последней версии Bombus. Чтобы воспользоваться версией, которая умеет сжимать траффик, выбирайте ''MIDP-2.0 ZLib''. 

Советую скачивать тестовые версии несмотря на то, что нормальная работоспособность этих версий не гарантируется (в крайнем случае они заменяютя на рабочие в течение ближайших суток с момента выхода последней тестовой версии). Ссылка на JAR-файл последней версии со сжатием траффика <tt><nowiki>http://bombus.jrudevels.org/builds/beta/midp2.0z/Bombus.jar</nowiki></tt>. Размер около 290Кб.

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

[[Image:Downloading-Bombus.jpg|center|thumb|Скачивание апплета]]

== Первый запуск ==
Ну что ж, телефон настроен, мидлет установлен, теперь можно его запустить! 

Если запуск не удался, то возможно ваш телефон не может работать с апплетами такого размера. В этом случая можно попробовать облегченную версию Bombus. {{todo|А где ее взять?}}

При первом запуске мидлет не будет иметь представления о том, какой [[JID]] использовать для соединения с [[server|сервером]]. Поэтому при первом запуске вы увидите на полоске загрузки текст ''Entering setup...'' и попадете в меню ''Account'' &mdash; настройки учетных записей.

[[Image:Bombus_Accounts_Free.jpg|center|thumb|Вид Bombus при первом запуске]]

При первом старте нужно создать учетную запись в самом клиенте &mdash; выберите ''New Acc''. Это нужно сделать не зависимо от того, есть у Вас JID или Вы собираетесь первый раз работать с Jabber. 

Перед Вами появится форма редактирования учетной записи, состоящая из множества полей ввода. Давайте рассмотрим по пунктам каждое из них (те, которые нужно менять, отмечены полужирным шрифтом):

* '''Username''' - если у вас уже есть свой [[JID]] на одном из [[server|серверов]], введите сюда Ваше имя пользователя (та часть JID, что стоит до @) на этом сервере. Если же у Вас нет своего JID, введите сюда желаемое имя пользователя. Рекомендации по выбору имени пользователя Вы можете найти на странице [[JID]].
* '''Password''' - введите сюда пароль для доступа к Вашему JID. Держите этот пароль в тайне: если он станет кому-то известен, безопасность Вашей переписки будет нарушена.
* '''Server''' - сюда введите имя своего [[server|сервера]].
* Host name/IP (optional) - оставьте незаполненным.
* Port - в большинстве случаев не нужно менять это поле.
* use SSl - установите флажок, если Вы хотите использовать защищенное SSL соединение, Ваш сервер это поддерживает и в телефоне есть нужные сертификаты.
* plaint-text password - необходимо установить только если Ваш сервер не поддерживает передачу пароля в шифрованном виде. Иначе пароль будет передаваться в открытом виде, что потенциально ставит под угрозу Вашу безопасность.
* '''No compression''' - снимите флажок для использования сжатия траффика.
* conferences only - при установке этого параметра, [[Bombus]] не будет загружать с сервера ваш [[roster|ростер (список контактов)]]. Этот режим предназначен для работы только в [[conference|конференциях]].
* Register Account - необходимо установить, если Вы еще не имеете собственного [[JID]].
* Keep-Alive - в большинстве случаев не нужно менять это поле.
* Keep-Alive period - в большинстве случаев не нужно менять это поле.
* [[Resource]] - по умолчанию тут содержится название клиента. Можно оставить это поле как есть, а можно вписать ''Mobile''. Про выбор ресурса можно почитать [[JID|тут]].
* Nickname - можно ввести сюда Ваш никнейм, который вы хотите использовать в конференциях.

Всё, настройка аккаунта закончена, теперь войдите в меню и нажмите OK. Bombus попытается подключиться к серверу, на экране телефона появится запрос, разрешить ли это соединение. Отвечайте утвердительно и далее будут отображаться этапы подключения: Connecting &rarr; Registering &rarr; Done (если Вы выбрали пункт ''Register Aсcount''). 

Если на стадии Connecting произошла ошибка, необходимо перепроверить доступность GPRS-Интернет на телефоне.

Если на стадии Registering появляется ошибка Conflict, необходимо выбрать другой [[JID]], так как этот уже кем-то занят. Войдите в меню Accounts, в меню выберите Edit и поправьте данные, затем повторите регистрацию сначала.

Если же пункт Register Account не был выбран, [[Bombus]] попробует подключиться к Вашей учетной записи. Если ему это не удалось, проверьте Ваше соединение с GPRS-Интернет и правильность ввода данных учетной записи.

===Советы===
* Если Вы запускаете Bombus одновременно с клиентом Jabber на компьютере, то установите более высокий [[Priority|приоритет]], чтобы сообщения доставлялись на телефон. Это можно сделать, отредактировав [[status|статус]].
* Для уменьшения объемов траффика, а, следственно, и экономии финансов пользуйтесь версией Bombus с [[Traffic compression|ZLIB-сжатием]].

== Мы соединились, что дальше? ==
Итак, настройки завершены, поздравляю, Вы в сети Jabber! Если Вы регистрировали новый аккаунт, Вы увидите контакт лист со всего лишь одним контактом &mdash; Вашим сервером:

[[Image:Bombus_Blank_Roster.jpg|center|thumb|Bombus при первом подключении]]

Вверху мы видим количество непрочитанных сообщений (рядом с конвертиком), иконку Вашего текущего [[Status|статуса]], и текущий профиль информирования о новых сообщениях (в данном случае &mdash; вибра).

Как видим, сервер прислал нам сообщение. Давайте прочтем его? Джойстиком, или клавишами 2/8 наведите курсор на пункт с конвертиком и нажмите джойстик или клавишу 5:

[[Image:Bombus_View_Message.jpg|center|thumb|Чтение приветственного сообщения '''jabber.ru''']]

Как видим, сервер приветствует нас. Сообщение не уместилось на экране полностью: Вы можете пролистать его с помощью джойстика или клавиш 2/8. Очевидно, что отвечать на это сообщение не имеет смысла.

Теперь Вы можете добавить своих друзей в [[roster|список контактов]] и начать общаться с ними! Делается это из главного меню. За более подробной информацией обратитесь к документации [[Bombus]].

Если же Вы не указывали опцию Register Account, Вы увидите свой [[roster|список контактов]]:

[[Image:Bombus_Roster.jpg|center|thumb|Ростер (список контактов)]]

Теперь Вы можете свободно общаться со своими друзьями.

== Использование конференций ==
[[Bombus]] поддерживает работу с [[conference|конференциями]]. Для того, чтобы в неё войти, необходимо в главном меню выбрать пункт "Conference", ввести имя пользователя, сервер конференции, желаемый никнейм, и, если конференция защищена паролем, пароль для доступа в неё. Также из меню Вы можете занести конференцию в закладки (Add bookmark), и быстро войти в конференцию через уже поставленную закладку (Bookmarks).

За более полной информацией, обратитесь к руководству [[Bombus]].

== Взаимодействие с другими системами общения ==

[[Bombus]] может взаимодейтсвовать с другими системами общения через т.н. [[gateway|транспорты]].

=== ICQ ===
Если у Вас под рукой компьютер с доступом к Интернету, рекомендуется сначала воспользоваться [[Migration|рекомендациями по миграции]] для наиболее корректного подключения транспорта ICQ с сохранением групп и назначенных Вами имён контактов.

Для того же, чтобы использовать подключить и сразу начать использовать [[ICQ]] через [[Bombus]] прямо на мобильном телефоне (смартфоне), нужно:
* Выбрать в главном меню пункт Tools, затем Service Discovery, затем дождаться, когда [[Bombus]] загрузит список сервисов, предоставляемых Вашим [[server|сервером]]:
[[Image:Bombus_Discovery.jpg|center|thumb|Список сервисов]]
* Выбрать курсором из списка сервис icq. Если его нет, необходимо найти его на каком-либо другом [[server|сервере]]. Для смены сервера, необходимо в меню выбрать пункт "Server", и ввести имя нового сервера. Затем выбрать пункт icq:
[[Image:Bombus_Browse_ICQ.jpg|center|thumb|Меню транспорта на примере icq.jabber.ru]]
* Выбрать Register, в появившейся форме ввести свой UIN (номер ICQ) и пароль ОТ НЕГО:
[[Image:Bombus_Enter_UIN.jpg|center|thumb|Регистрация на транспорте]]
* Вернитесь к [[roster|списку контактов]], выбрав в меню Close. Если все прошло успешно, Вы увидите в нём свои ICQ-контакты и сообщение от [[gateway|транспорта]] о запросе [[subscription|подписки]]:
[[Image:Bombus_ICQ_Contacts.jpg|center|thumb|Получено сообщение от транспорта]]
* Подписать транспорт: Actions&rarr;Subscriptions&rarr;Grant Subsription и Ask subscription.
* Как Вы, наверно, заметили ICQ контакты отображаются номерами, а не никами, как хотелось бы. Не уводя курсор с транспорта, нажмите Actions&rarr;Resolve Nicknames и номера автоматически преобразуются в никнеймы.

Для того, чтобы добавить нового пользователя ICQ в [[roster|список контактов]], необходимо в главном меню выбрать опцию Add contact, в поле User JID написать номер ICQ добавляемого контакта, в поле Transport выбрать icq, в поле Name ввести никнейм контакта, а также, по желанию, выбрать группу, в которую необходимо добавить контакт, после всего этого в меню выбрать Add и подписать контакт также, как это представлено выше для транспорта.

Список ICQ-транспортов и FAQ по их подключению в [[Bombus]] -- в статье '''[http://bombus-im.org/wiki/howto/howto_icq Подключение и настройка ICQ-транспорта в Bombus]'''.

=== IRC ===

Для того, чтобы войти на канал [[IRC]] через [[Bombus]], нужно:
* Выбрать в главном меню пункт Tools, затем [[Service Discovery]], затем дождаться, когда Bombus загрузит список сервисов, предоставляемых Вашим [[server|сервером]].
* Выбрать курсором из списка сервис irc. Если его нет, можете найти его на каком-либо другом [[server|сервере]] (публичные irc-транспорты доступны на e.jabber.ru, jabber.snc.ru и др.). Для смены [[server|сервера]], необходимо в меню выбрать пункт "Server", и ввести имя нового сервера (например, e.jabber.ru). Затем выбрать пункт irc.
* При поключению к сети IRC возможны проблемы с кодировками. Если Вы (или ваши собеседники в канале IRC) видите [http://ru.wikipedia.org/wiki/Крокозябры "крокозябры" (непонятные символы)], можете изменить кодировку, заданную транспортом по умолчанию. Для этого необходимо зарегистрироваться на транспорте. В Bombus: навести курсор (выделение) на транспорт IRC, нажать кнопку "Меню", Выбрать Register, в появившейся форме ввести свой никнейм (IRC Username), в поле Encodings задать кодировки для каждого из IRC-серверов, которые собираетесь посещать. Пример: <tt><nowiki>[{"irc.lucky.net","koi8-r"},{"irc.xl.ru","cp1251"}]</nowiki></tt>
* И, наконец, чтобы войти на канал, нужно: в главном меню выбрать пункт [[Conference]] (Конференции), в поле Room заполнить имя_канала%IRC_сервер, например, <tt>sahalin%irc.xl.ru</tt>, в поле Host ввести имя Вашего IRC-транспорта, например, <tt>irc.e.jabber.ru</tt>, выбрать Join в меню. Если все прошло удачно, в [[roster|списке контактов]] Вы увидите новую группу, носящую название канала и IRC-сервера:
[[Image:Bombus_IRC_Roster.jpg|center|thumb|IRC-комната и её учатники в ростере Bombus]]
* Для того, чтобы читать и писать в канал, необходимо войти в пункт под именем <tt>канал%сервер@irc-транспорт</tt>, например <tt>sahalin%irc.xl.ru@irc.e.jabber.ru</tt>:
[[Image:Bombus_IRC.jpg|center|thumb|Чат в канале IRC]]

Также можете попробовать обратиться к '''[http://bombus.jrudevels.org/wiki/bombus/help Справке Bombus]'''.

[[Category:Documentation]]
[[Category:HowTo]]
[[Category:Bombus]]