> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ss14.art/llms.txt
> Use this file to discover all available pages before exploring further.

# Pda messaging

## PDA сообщения

<Warning title="Внимание: устаревшая документация!">
  Этот документ перенесён из периода до реорганизации игровых зон и не был проверен или обновлён.
  Он может не соответствовать новым требованиям дизайна отделов.
</Warning>

| Дизайнеры                  | Реализовано | GitHub |
| -------------------------- | ----------- | ------ |
| Julian & VasilisThePikachu | :x: Нет     | TBD    |

*(Взято из [документа Julian](https://hackmd.io/iu2yK9bcQb-veuCOLl-FYw?both#Optional-Channels-and-Department-based-Channels) в hackmd и немного изменено. В основном заменено "email" на "message", "Email address" на "user/user id" и добавлены некоторые свои правки. Julian был не против, если я правильно понял (я был с ним в голосовом канале))*

*(В основном взято из того, как работают PDA сообщения в ss13)*
Позволяет отправлять сообщения другим с помощью PDA.

### Что это добавляет и зачем

Просто — обмен сообщениями через PDA!
Отправлять сообщения кому-то через PDA следует, когда нужно привлечь внимание конкретного человека. Например, как HoS вы хотите попросить детектива подойти и осмотреть предмет. Легче привлечь его внимание, так как его PDA будет вибрировать, чем надеяться, что он следит за своим каналом. Другое использование — главы, планирующие капитану сюрприз на день рождения. Что-то подобное потребовало бы собрать всех глав в одном месте.

Это **не** замена радиоканалу. Нет «общего» канала, было бы легко подделать чужую личность (нужен только их ID), прошлые сообщения с того же ID легко раскрыть, и отправлять сообщения через PDA гораздо более громоздко, чем просто использовать радио.

### Хранение сообщений

Сообщения хранятся на сервере, который, скорее всего, будет находиться в телекоммуникациях. Может быть один сервер на станцию; другие на той же станции не будут использоваться, если первый не потеряет питание или не будет уничтожен.

*Опционально* Активный сервер синхронизируется со всеми неактивными серверами на той же станции (это происходит внутри системы напрямую, без сетевого взаимодействия устройств).

### Модель «Один активный / несколько неактивных серверов»

(Здесь говорится о некоторых вещах, связанных с рефакторингом, и Julian сказал мне, что они забыли вставить ссылку. Я оставляю это на всякий случай, если это действительно полезно.)

Модель «один активный / несколько неактивных серверов» использует систему, которая будет выделена в отдельную систему из сервера мониторинга экипажа [link text]().

Система клиента обмена сообщениями будет использовать метод `GetActiveServer` системы сервера сообщений для получения активного сервера, если у клиента ещё не установлен сервер или этот сервер превысил таймаут. *Это тоже из системы, которая будет выделена.*

### Отправка и получение сообщений

При отправке сообщения кому-то через программу PDA отправляет сообщение вместе с «user id» на сервер, и сервер отправляет сообщение целевому устройству. Конечно, будет ограничение на количество символов (скажем... 100 символов?).

Когда PDA получает сообщение, он воспроизводит рингтон PDA и вибрирует, показывая отправленное сообщение в чате. Это сообщение также можно просмотреть на PDA через программу.

Уведомления можно отключить при желании.

Этот user id может быть сгенерирован в ID-карту, так что если вы получите новый PDA, ваши сообщения сохранятся, пока вы используете ту же ID-карту. Опоздавшие получат uid по прибытии на станцию. Возможно, HoP или RD смогут перенести ваш UID на новую ID-карту с помощью ID-компьютера, сделав старую ID-карту бесполезной. Это также может предотвратить павергейминг путём смены UID для просмотра чужих сообщений.

Этот UID будет получать сообщения, пока он находится на станции и в PDA.

Если его нет на станции, сообщения могут либо не отправляться, либо добавляться в очередь для отправки, когда он снова войдёт на станцию.

Поскольку UID хранится на ID, это означает, что если вы завладеете чьей-то ID-картой, вы можете общаться от их имени и, возможно (если добавить), читать их сообщения.

### Список пользователей

При открытии приложения обмена сообщениями PDA вы сможете начать сеанс чата со всеми, кто подключён к серверу (то есть со всеми, у кого есть PDA).

Они будут отображаться по имени и должности: «Vapor-Tail (Captain)».

*Опционально* Добавьте возможность запретить другим инициировать разговор с помощью опции. Это может быть полезно для высокопоставленного персонала, такого как капитан, чтобы не получать спам-сообщения от клоуна и других в начале смены.

### Опционально: Detomatix PDA картридж

(Оригинальный предмет можно найти в вики tg: [https://tgstation13.org/wiki/Syndicate\_Items](https://tgstation13.org/wiki/Syndicate_Items))

Detomatrix — это... проще говоря, zip-бомба. Позволяет отправить поддельное сообщение, которое при быстром открытии целью выводит из строя PDA и его ID (вместо взрыва... хотя это забавнее, мейнтейнеры, разрешите пожалуйста).

Существует вероятность неудачи, и ещё меньшая вероятность срабатывания на «высокоприоритетных» PDA, таких как у капитана.

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

### Опционально: Поддержка нескольких сетей

Сервер может отправлять сообщения по беспроводной и проводной сети, потому что он сохраняет, в какой сети зарегистрированы устройства, вместе с user id и сетевым адресом.

Для этого требуется, чтобы устройства могли регистрироваться с двумя идентификаторами device net одновременно (что следует делать только в случае крайней необходимости).

### Опционально: Каналы и каналы по отделам

Каналы — это специальные группы, которые ретранслируют отправленные в них сообщения пользователям, подписанным на этот канал.

Каналы можно создавать и удалять создателем канала.

При регистрации на сервере клиент также отправляет должность вставленного ID, чтобы сервер мог поместить их в специальные каналы отделов.

Каналы отделов нельзя присоединить, покинуть или удалить.

### Опционально: Консоль управления сообщениями RD

Научный руководитель и, возможно, капитан получают консоль, которая подключается к серверу сообщений через device net. Её можно использовать для просмотра и управления всеми сообщениями и группами.
Она использует device net с `AccessComponent` на сервере сообщений, так что функции управления могут быть перехвачены предателями, завладевшими ID-картой с соответствующим доступом. (Требует реализации [ограничений доступа device net](https://hackmd.io/gPjP95_zRUiT-bX4hKxE6w).)

### Опционально: pAI в качестве ассистента чата

Это добавит новый геймплей для призрачной роли pAI. Позволяя pAI общаться от имени хозяина. Может быть маленькая иконка pAI в чате, показывающая, что сообщение отправлено pAI, а не самим игроком. pAI уже некоторое время были довольно скучными и, возможно, заслуживают собственного дизайн-документа с идеями, но это одна из моих идей, которая приходит на ум.

### Опасения

Когда меня впервые спросили об этом, я столкнулся с некоторыми опасениями. Этот раздел для их рассмотрения.

Начало обсуждения в Discord: [https://discord.com/channels/310555209753690112/310555209753690112/1160244698112327830](https://discord.com/channels/310555209753690112/310555209753690112/1160244698112327830)

##### Зачем нужно общение через PDA вместо обычного радио? Не нарушит ли это баланс радио и уменьшит ли общение по радио?

Прежде всего, зачем:
Если вы играете в игру, вы быстро понимаете, что привлечь чьё-то внимание, не дай бог нескольких, может быть... мягко говоря, непростой задачей. Вам либо везёт, и нужный человек просто случайно следит за чатом, либо он занят и не обращает внимания. В итоге ваше сообщение теряется, пока вы не отправите его снова или не попытаетесь его найти. Это просто не весело и просто раздражает. Обмен сообщениями через PDA может решить эту проблему.

Что касается того, нарушит ли это баланс радио: крайне маловероятно. В основном потому, что:

1. Обмен сообщениями через PDA не позволит вам привлечь внимание нескольких человек одновременно (в основном). PDA сообщение может достичь одного человека за раз (если только у нас не будет групп по отделам, но даже тогда). Вам придётся пройти через множество препятствий, если вы ХОТИТЕ использовать только сообщения. Радио проще и быстрее, и оно доходит до нескольких человек сразу.
2. Отправка PDA сообщения — это больше хлопот, чем просто использование радиоканала. Для отправки PDA сообщения потребуется как минимум 6 шагов: открыть PDA, перейти в раздел приложений, запустить приложение, найти человека, написать сообщение и отправить. А если вы держите чат открытым, это будет занимать большую часть экрана. Или вы можете просто сказать `:c Captain hamlet ate uranium`.
3. Сообщения сохраняются и логируются. Кто-то украл PDA капитана? Теперь все их сообщения выставлены напоказ. По радио, если у них не было канала командования, они никогда не узнали бы о прошлых сообщениях. Если два синдиката решат использовать PDA сообщения, RD может просто забрать их чаты. То же самое, если синдикаты будут использовать их для общения друг с другом.
4. В PDA сообщениях довольно маленький лимит символов, если вы хотите сказать что-то длинное, радио — это то, что нужно.

Возможно, это неправильный раздел, но администраторы также могут использовать это для работы «Центральным Командованием», так что вместо отправки скрытого сообщения кому-то они могут просто отправить сообщение на их PDA.

##### Это снижает ситуационную осведомлённость всех остальных, так как люди больше не видят все сообщения по радио.

Я категорически не согласен. Сомневаюсь, что это снизит ситуационную осведомлённость больше, чем она уже снижена. Я уже говорил о том, как мониторинг радиоканала на предмет сообщений, адресованных вам, — это уже хлопотно. Имена в PDA сообщениях можно легко изменить, используя чужой ID, поэтому не стоит идти в техничку, как вам сказали, а вместо этого показать сообщение охране.

##### Почему бы не использовать факс?

Это вообще вопрос? Во-первых, не у всех есть факс, во-вторых, нужно быть рядом, чтобы услышать, как он печатает. И если вы не проверяете факс периодически на предмет новых сообщений, вы можете их пропустить. А даже если вы его проверите, там, вероятно, ASCII-спам, повторённый 10 раз. И почему мы вообще используем *факсы* в 2563 году или в каком там году происходит действие SS14.

Это были все опасения, которые я смог найти в Discord.
