⚠️ Примечание: следите за обновлениями в и на сервере Discord Developers на канале api-announcements. Там вы можете найти дополнительную информацию о том, когда и как пройдет перенос имен приложений. Тем временем, параграф “Посмотрите свой код” поможет вам узнать, какие шаги вы можете предпринять для подготовки.
О чем данная статья
- Как это повлияет на приложения
- Верифицированные приложения
- Неверифицированные и новые приложения
- Как подготовиться
Discord объявил о введении новых имен пользователей, и эта статья поможет вам понять, как приложения перейдут на эту новую систему! Прежде всего изучите статью о новых именах пользователей, ознакомившись с новой концепцией, и затем мы расскажем, как это повлияет на приложения и как к этому можно подготовиться.
Как это повлияет на приложения
Во время перехода на новую систему имен пользователей приложения получат несколько обновлений.
- У всех приложений будет пользователь-бот.
- Имена пользователей и иконки ботов будут по умолчанию соответствовать имени и иконке приложения.
- Приложения будут переведены на новую систему имен пользователей, как указано в разделе "Допустимые символы".
- Приложениям может потребоваться обновить свой код для поддержки новой системы имен пользователей.
Добавление пользователей-ботов во все приложения
В дальнейшем каждое приложение будет сопровождаться созданием бота-пользователя. Приложениям, у которых в настоящее время нет бот-пользователей, они будут назначены во время перехода на новые имена пользователей. Обратите внимание, что если приложению не требуется пользователь-бот, то его можно просто не указывать в bot scope при установке.
Объединение имен и значков ботов
Имя пользователя и значок бота верифицированного приложения теперь будут совпадать с теми, которые заданы на странице "General Overview" в настройках приложения. В случае неверифицированного приложения только иконка бота будет совпадать с иконкой приложения. Это изменение упрощает процесс разработки приложений и помогает пользователям понять взаимосвязь между приложениями и их ботами в Discord.
Уникальные имена для всех приложений
Во время перехода приложениям и пользователям ботов будут автоматически присвоены новые имена пользователей. Новые имена пользователей по-разному влияют на верифицированные и неверифицированные приложения, поэтому важно обратить внимание на то, как это относится к вашему приложению.
⚠️ Примечание: это изменение не повлияет на имена серверов приложений.
Верифицированные приложения
Имена верифицированных приложений, как и имена пользователей, должны быть уникальными, а имена пользователей ботов будут автоматически переноситься на имя приложения. Например, приложение с именем App#1234 будет перенесено на новое имя приложения и имя пользователя бота: @app. Имена приложений будут состоять из 2-32 символов, состоящих только из строчных латинских букв, цифр и/или подчеркивания _ и одной точки подряд. Имейте в виду, что если текущее имя приложения превышает 32 символа, оно будет сокращено. Разработчикам также стоит обратить внимание на следующие обстоятельства, которые потребуют внимания.
Дублирующиеся имена приложений
Автоматический процесс перехода может привести к тому, что несколько приложений будут иметь одинаковое имя. Чтобы избежать этого, к новому имени приложения, где это может произойти, будет добавлен его текущий 4-значный дискриминатор. Как в приведенном выше примере, @app будет недоступен, поэтому другое приложение с именем App#6789 будет перенесено как @app6789. Помните, что всем приложениям будет предоставлена одноразовая возможность изменить свое имя на портале разработчиков.
Запрещенные символы в именах приложений
Если текущее имя приложения содержит запрещенные символы, процесс перехода будет несколько отличаться. Если имя приложения содержит смесь разрешенных и запрещенных символов, как описано в пункте "Как подготовиться" ниже, запрещенные символы будут удалены из имени, и останутся только разрешенные символы. Например, приложение с именем !..A..p..p..#1234 получит имя @app.
Однако если имя приложения полностью состоит из запрещенных символов, приложению будет присвоено случайное имя. Затем вы можете изменить название приложения на желаемое, воспользовавшись одноразовой возможностью на странице портала разработчиков приложения.
Неверифицированные и новые приложения
Как упоминалось выше в пункте "Добавление пользователей-ботов во все приложения", у всех приложений будут пользователи-боты. Имена пользователей ботов для нетверифицированных и вновь созданных приложений будут генерироваться случайным образом. Но помните: сейчас важнее всего название приложения, потому что именно его будут видеть пользователи в Discord. Пока приложение не подало заявку на верификацию, разработчики могут менять название приложения. Как всегда, перед подачей заявки на верификацию убедитесь, что название вашего приложения выбрано в соответствии с вашими пожеланиями.
Во время подачи заявки на верификацию имена пользователей ботов вашего приложения будут обновлены, чтобы соответствовать имени приложения. Однако если текущее имя приложения недоступно, разработчики могут выбрать уникальное имя приложения.
Как подготовиться
Планируйте наперед! Независимо от того, есть ли у вас уже верифицированное приложение или вы планируете его запустить, выбор имени пользователя приложения очень важен, поэтому уделите некоторое время продумыванию имени пользователя и того, как оно может наилучшим образом представлять бренд приложения.
При подборе имени приложения учитывайте следующую информацию:
Допустимые символы для новых имен пользователей:
- Латинские буквы a-z
- Цифры 0-9
- Некоторые специальные символы
- _
- .
Ограничения для новых имен пользователей:
- Имя пользователя должно состоять из не менее 2 и не более 32 символов;
- Имена пользователей нечувствительны к регистру и всегда конвертируются в нижний регистр;
- В именах пользователей не могут использоваться какие-либо специальные символы, кроме нижнего подчеркивания (_) и точки (.)
- В именах пользователей нельзя использовать 2 точки подряд ..
- (.a.b. - разрешено; a..b. - невозможно использовать);
- Имена пользователей уникальны для каждого, два пользователя не могут использовать одно и то же имя пользователя;
- Имена пользователей (и отображаемые имена) должны соответствовать нашим Правилам сообщества. Вот некоторые примеры имён, которые не разрешено использовать:
- Имена пользователей, используемые для выдачи себя за Discord, сотрудников Discord или системные сообщения Discord;
- Имена пользователей, используемые для выдачи себя за человека, группу или организацию;
- Имена пользователей, направленные против других людей или разжигающие ненависть;
- Имена пользователей, содержащие откровенно сексуальные выражения.
Посмотрите свой код
Поскольку изменение имени пользователя уже не за горами, рекомендуем пересмотреть свой код и убедиться, что никакая система не опирается на имена пользователей или названия приложений.
- Если ваш код ссылается на имена пользователей вместо ID, мы рекомендуем внести изменения в код для более плавного перехода.
- Если код зависит от полезной нагрузки пользователя или дискриминаторов (тегов), и обновите его. Во время перехода имена пользователей будут появляться в данных полезной нагрузки с дискриминатором (тегом) #0. Обязательно учитывайте этот временный дискриминатор (тег) при обновлении кода.
Часто задаваемые вопросы
Зачем Discord вносит это изменение для приложений?
Боты (приложения) являются типом пользователя, поэтому на них влияет изменение имени пользователя, как и на обычных пользователей Discord. Конкретные изменения для верифицированных и неверифицированных приложений помогут защититься от ботов, которые являются подделками, и продвинут платформу к использованию имен приложений, а не имен пользователей ботов.
Пожалуйста, прочтите пост в блоге, чтобы узнать, почему было внесено это изменение.
Могу ли я верифицировать свое приложение перед переходом, чтобы оно было зарезервировано?
Нет, у приложений, верифицированных после 2 мая имя пользователя не будет зарезервировано.
Приложения, верифицированные после 2 мая, по-прежнему смогут однократно изменить имя во время перехода.
Могу ли я изменить имя своего приложения до перехода?
При подготовке к переходу сменить имя приложения будет временно невозможно.
Если ваше приложение верифицировано, вскоре вам будет предоставлена однократная возможность изменить имя вашего приложения.
Если ваше приложение не верифицировано, вы по-прежнему сможете самостоятельно изменить его имя на портале для разработчиков.
Когда приложения смогут обновить свое имя?
Следите за обновлениями здесь, в журнале изменений (Change Log) и на канале api-announcements сервера Discord Developers для получения дополнительной информации о том, когда и как будет происходить переход к новым именам приложений. Тем временем изучите параграф «Просмотрите свой код» (Review Your Code), содержащий шаги, которые вы можете предпринять для подготовки.
В конечном итоге, объединяя имя вашего приложения и бота-пользователя, мы надеемся, что уникальные имена приложений помогут пользователям больше доверять бренду вашего приложения и понимать его лучше.
Как всегда, если у вас возникли дополнительные вопросы, обращайтесь в службу поддержки разработчиков.