⚠️ Nota: rimanete sintonizzati qui nel, e sul canale degli api-announcements Discord Developers server, per ulteriori informazioni su quando e come avverrà la migrazione dei nomi delle applicazioni (app). Nel frattempo, la sezione Rivedi il tuo codice ti aiuterà a darti un'idea dei passaggi che puoi intraprendere per prepararti.
Sommario
Discord ha annunciato il rilascio di nuovi nomi utente e questo articolo ti aiuterà a capire come verranno migrate le app su questo nuovo sistema! Prenditi del tempo per rivedere l'articolo sui nuovi nomi utente e familiarizzare con il concetto generale, quindi possiamo discutere cosa significa, come influenzerà le app e come essere pronti.
In che modo le app sono interessate
Gli sviluppatori possono aspettarsi che le loro app ricevano un paio di aggiornamenti durante la migrazione al nuovo sistema di nomi utente.
- Tutte le app avranno un utente bot.
- I nomi utente e le icone dei bot verranno impostati automaticamente sul nome e sull'icona dell'app.
- Le app verranno migrate al nuovo sistema di nome utente come descritto nella sezione Caratteri consentiti.
- Le app potrebbero dover aggiornare il proprio codice per supportare il nuovo sistema di nome utente.
Utenti bot aggiunti a tutte le app
Andando avanti, ogni app comporterà la creazione di un utente bot. Alle app attualmente prive di utenti bot ne verrà assegnata una durante la migrazione. Tieni presente che se un'app non richiede un utente bot, il bot scope può essere semplicemente omesso durante l'installazione.
Unificazione dei nomi e delle icone dei bot
Il nome utente e l'icona di un bot di un'app verificata ora saranno gli stessi impostati nella pagina Panoramica generale delle impostazioni di quell'app. Per un'app non verificata, solo l'icona del bot sarà uguale a quella dell'app. Questa modifica semplifica il processo di sviluppo delle app aiutando gli utenti a comprendere la relazione tra le app e i loro bot su Discord.
Nomi univoci per tutte le app
Durante la migrazione, agli utenti di app e bot verranno automaticamente assegnati nuovi nomi utente. I nuovi nomi utente influenzano le app verificate e non verificate in modi diversi, quindi è importante notare come si applica alla tua app.
⚠️ Nota: i nickname del server dell'app non saranno interessati da questa modifica.
App verificate
I nomi delle app verificati, come i nomi utente, dovranno essere univoci e i nomi utente dei bot verranno migrati automaticamente al nome dell'app. Ad esempio, un'app denominata App#1234 verrebbe migrata a un nuovo nome app e nome utente bot: @app.I nomi delle app saranno compresi tra 2 e 32 caratteri, costituiti solo da caratteri latini minuscoli, numeri e/o trattino basso _ e un punto consecutivo. Tieni presente che se il nome corrente di un'app è maggiore di 32 caratteri, verrà troncato . Gli sviluppatori vorranno anche prestare attenzione alle seguenti circostanze che richiedono attenzione.
Nomi app duplicati
Il processo di migrazione automatica potrebbe comportare che più app condividano lo stesso nome. Per evitare ciò, qualsiasi app in cui ciò potrebbe verificarsi avrà il suo attuale discriminatore a 4 cifre aggiunto al nuovo nome dell'app. Come nell'esempio precedente, @app non sarebbe disponibile, quindi un'altra app denominata App#6789 verrebbe migrata come @app6789. Ricorda che a tutte le app sarà concessa un'opportunità una tantum per cambiare il proprio nome sul Portale per gli sviluppatori.
Caratteri limitati nei nomi delle app
La migrazione sarà leggermente diversa se il nome corrente di un'app contiene caratteri limitati. Se il nome dell'app contiene una combinazione di caratteri consentiti e limitati, come indicato nella sezione Come preparare di seguito, il nome verrà rimosso dai caratteri limitati in modo che rimangano solo i caratteri consentiti. Ad esempio, un'app denominata !..A..p..p..#1234 verrebbe cancellata e migrata come @app.
Tuttavia, se il nome di un'app è composto interamente da caratteri limitati, all'app verrà assegnato un nome casuale. Puoi quindi aggiornare l'app con il tuo nome preferito con l'opportunità una tantum assegnata di modificare il nome dalla pagina del portale per gli sviluppatori dell'app.
App nuove e non verificate
Come accennato in Utenti bot aggiunti a tutte le app, sopra, tutte le app avranno utenti bot. I nomi utente dei bot per le app non verificate e appena create verranno generati in modo casuale. Ma ricorda: è il nome dell'app che è più importante ora perché è quello che gli utenti vedranno su Discord. Fino a quando un'app non richiede la verifica, gli sviluppatori possono comunque modificare il nome dell'app. Come sempre, assicurati che il nome della tua app sia impostato sul nome che desideri prima di richiedere la verifica.
Al momento dell'applicazione di verifica, i nomi utente del bot della tua app verranno aggiornati in modo che corrispondano a quelli dell'app. Tuttavia, se il nome corrente dell'app non è disponibile, gli sviluppatori hanno la possibilità di scegliere un nome univoco per l'app.
Come preparare
Pianificare in anticipo! Se attualmente hai o prevedi di avere un'app verificata, la scelta del nome utente di un'app è importante, quindi prenditi del tempo per pianificare il tuo nome utente e come può rappresentare al meglio il marchio dell'app.
Considera le seguenti informazioni quando pianifichi il nome di un'app:
Caratteri consentiti per i nuovi nomi utente:
- Caratteri latini a-z
- Numeri 0-9
- Alcuni caratteri speciali
- _
- .
Restrizioni per i nuovi nomi utente:
- I nomi utente devono essere lunghi almeno 2 caratteri e al massimo 32 caratteri
- I nomi utente non fanno distinzione tra maiuscole e minuscole e forzano le minuscole
- I nomi utente non possono utilizzare altri caratteri speciali oltre al carattere di sottolineatura _ e al punto .
- I nomi utente non possono utilizzare 2 caratteri punto consecutivi..
- (.a.b. è consentito, a..b non è consentito)
- I nomi utente sono univoci per ogni utente e due utenti non possono condividere lo stesso nome utente
- I nomi utente (e i nomi delle app) devono rispettare le nostre Linee guida della community. Alcuni esempi di nomi utente non consentiti includono:
- Nomi utente usati per impersonare Discord, Discord staff o messaggi di sistema Discord
- Nomi utente utilizzati per impersonare un individuo, un gruppo o un'organizzazione
- Nomi utente che attaccano altre persone o promuovono l'odio
- Nomi utente che contengono un linguaggio sessualmente esplicito
Rivedi il tuo codice
Con il cambio di nome utente dietro l'angolo, è una buona idea rivedere il codice e assicurarsi che nessuna logica si basi su nomi utente o nomi di app.
- Se il tuo codice fa riferimento a nomi utente anziché ID, ti consigliamo di apportare modifiche al codice per una transizione più agevole.
- Identifica il codice che dovrà essere aggiornato se si basa sui payload dell'utente o sulla manipolazione di discriminatori. Durante la migrazione, i nomi utente appariranno nei payload con un discriminatore #0. Assicurati di tenere conto di questo discriminatore temporaneo durante l'aggiornamento del codice.
Domande frequenti
Perché Discord sta apportando questa modifica all’app?
Gli utenti bot associati alle app sono un tipo di utente, quindi sono interessati dalla modifica del nome utente proprio come i normali utenti di Discord. Le modifiche specifiche per le app verificate e non verificate aiutano a proteggere dall’impersonificazione e spingono la piattaforma verso l'utilizzo dei nomi delle applicazioni anziché dei nomi utente dei bot.
Si prega di leggere il nostro post sul blog per ulteriori informazioni sul motivo per cui è stata apportata questa modifica.
Posso far verificare la mia app prima della migrazione per assicurarmi che venga prenotata?
No, le app verificate dopo il 2 maggio non avranno un nome utente riservato.
Queste app potranno comunque eseguire una singola modifica del nome al momento della migrazione.
Posso cambiare il nome della mia app prima della migrazione del nome?
In vista della migrazione, le modifiche ai nomi delle app verranno temporaneamente sospese.
Se la tua app è verificata, ti verrà presto offerta un'opportunità univoca per poter cambiare il nome della tua app.
Se la tua app non è verificata, potrai continuare a modificarne il nome autonomamente all'interno del portale per sviluppatori.
Quando potranno essere aggiornati i nomi delle app?
Resta sintonizzato al registro delle modifiche e al canale serverapi-announcements, del server Discord Developers per ulteriori informazioni su quando e come avverrà la migrazione dei nomi delle applicazioni (app). Nel frattempo, la sezione Rivedi il tuo codice potrà aiutarti per dare un'idea dei passaggi che puoi intraprendere per prepararti.
In definitiva, unificando il nome della tua app e dell'utente del bot, la nostra speranza è che nomi di app univoci aiutino gli utenti a sviluppare un più profondo senso di fiducia e comprensione quando interagiscono con il brand della tua app.
Come sempre, se hai ulteriori domande, contatta il supporto per gli sviluppatori..