Discord.py: differenze tra le versioni

Naviga nella cronologia in modo interattivo

← Differenza precedente

Contenuto cancellato Contenuto aggiunto

VisualeWikitesto

Versione delle 18:45, 26 ott 2023 modifica LeoCx1000 (discussione \| contributi) 4 modifiche Updated the page to reflect the latest changes in discord.py Etichette: Possibile modifica di prova o impropria Modifica visuale ← Differenza precedente		Versione attuale delle 14:33, 28 feb 2025 modifica annulla FrescoBot (discussione \| contributi) Bot 3 578 440 modifiche m Bot: errori di battitura
(6 versioni intermedie di 5 utenti non mostrate)
Riga 3: \|Nome = discord.py \|Sviluppatore = Rapptz \|UltimaVersione = 2.34.20 \|SistemaOperativo = multipiattaforma \|Linguaggio = Python Riga 16: La libreria discord.py è stata sviluppata da Rapptz come modulo Python per sviluppare Bot per la piattaforma [[VoIP]] [[Discord (software)\|Discord]]. La prima versione della libreria è stata rilasciata il 23 agosto 2015<ref>{{Cita web\|url=https://github.com/Rapptz/discord.py/releases/tag/v0.1.0\|titolo=Release v0.1.0 · Rapptz/discord.py\|sito=GitHub\|lingua=en\|accesso=2021-05-12}}</ref>, compatibile con versioni di Python 2.7+ e 3.3+. La versione 0.10.0 è stata rilasciata il 28 giugno 2016<ref>{{Cita web\|url=https://github.com/Rapptz/discord.py/releases/tag/v0.10.0\|titolo=Release v0.10.0 · Rapptz/discord.py\|sito=GitHub\|lingua=en\|accesso=2021-05-12}}</ref> è stata la prima versione totalmente compatibile col modulo ''asyncio'', che permette di scrivere codice Python usando la [[sintassi]] async/await<ref>{{Cita web\|url=https://docs.python.org/3/library/asyncio.html\|titolo=asyncio — Asynchronous I/O — Python 3.9.5 documentation\|sito=docs.python.org\|lingua=EN\|accesso=2021-05-12}}</ref>. Il 9 aprile 2019 è stata rilasciata la versione v1.0.0<ref>{{Cita web\|url=https://github.com/Rapptz/discord.py/releases/tag/v1.0.0\|titolo=Release v1.0.0 · Rapptz/discord.py\|sito=GitHub\|lingua=en\|accesso=2021-05-12}}</ref>, frutto di una completa ristrutturazione<ref>{{Cita web\|url=https://discordpy.readthedocs.io/en/stable/migrating.html#migrating-1-0\|titolo=Migrating to v1.0\|sito=discordpy.readthedocs.io\|lingua=EN\|accesso=2021-05-12}}</ref> e con molteplici cambiamenti non retrocompatibili; inoltre, è stato abbandonato il supporto per Python 3.4 e precedenti. Riga 22: I creatori hanno annunciato la fine dello sviluppo della libreria<ref name=":1">{{Cita web\|url=https://gist.github.com/Rapptz/4a2f62751b9600a31a0d3c78100287f1\|titolo=The future of Discord.py\|autore=Rapptz\|sito=Github\|data=28 Agosto 2021\|lingua=EN\|accesso=21 Ottobre 2021}}</ref> a fine Agosto 2021<ref name=":1" />, per poi riprendere lo sviluppo<ref>{{Cita web\|url=https://gist.github.com/Rapptz/c4324f17a80c94776832430007ad40e6\|titolo=On Resuming discord.py Development\|autore=Rapptz\|sito=GitHub Gists\|lingua=en\|accesso=2022-03-26}}</ref> nei primi giorni di Marzo 2022. Il 18 agosto 2022 è stata rilasciata la version v2.0.0<ref>{{Cita web\|url=https://github.com/Rapptz/discord.py/releases/tag/v2.0.0\|titolo=Release v2.0.0 · Rapptz/discord.py\|sito=GitHub\|lingua=en\|accesso=2023-10-26}}</ref>, che portò molti cambiamenti non retrocompatibili<ref>{{Cita web\|url=https://discordpy.readthedocs.io/en/stable/whats_new.html#v2-0-0\|titolo=Changelog — v2.0.0\|sito=discordpy.readthedocs.io\|lingua=EN\|accesso=2023-10-26}}</ref>, i più notevoli sono una completa revisione di molte componenti async<ref>{{Cita web\|url=https://discordpy.readthedocs.io/en/stable/migrating.html#asyncio-event-loop-changes\|titolo=asyncio Event Loop Changes\|sito=discordpy.readthedocs.io\|accesso=2023-10-26}}</ref>, e la rimozione del supporto per gli account utente<ref>{{Cita web\|url=https://discordpy.readthedocs.io/en/stable/migrating.html#removal-of-support-for-user-accounts\|titolo=Removal of Support For User Accounts\|sito=discordpy.readthedocs.io\|accesso=2023-10-26}}</ref>, consentendo fare [[login]] solo con gli account bot, in conformità con le modifiche ai termini di servizio di Discord<ref>{{Cita web\|url=https://support.discord.com/hc/en-us/articles/115002192352-Automated-user-accounts-self-bots\|titolo=Automated user accounts (self-bots)\|lingua=EN}}</ref>; inoltre, è stato abbandonato il supporto per Python 3.7 e precedenti. La versione più recente è la 2.34.20<ref name=":0">{{Cita web\|url=https://discordpy.readthedocs.io/en/stable/whats_new.html\|titolo=Versioni di Discord.py\|sito=discordpy.readthedocs.io\|lingua=EN}}</ref>. == Utilizzo == Dopo aver importato il modulo discord.py in un programma, è possibile utilizzare i suoi metodi per creare il codice di un Bot, il quale a tutti gli effetti può agire su Discord come un utente umano, ma avendo anche certe funzioni extra come i comandi ~~applicazzione~~applicazione<ref>{{Cita web\|url=https://discord.com/developers/docs/interactions/application-commands\|titolo=Application Commands\|sito=Discord Developer Portal\|lingua=EN\|accesso=2023-10-26}}</ref> e le componenti di messaggio<ref>{{Cita web\|url=https://discord.com/developers/docs/interactions/message-components\|titolo=Message Components\|sito=Discord Developer Portal\|lingua=EN\|accesso=2023-10-26}}</ref>. === Funzioni === Riga 35: * allegare file ad essi messaggi * scrivere in privato agli utenti * bannare, ~~espulsare~~espellere e moderare gli utenti * eliminare messaggi e canali * creare guilds<ref>Funzione disponibile solo se il bot è in meno di 10 guild.</ref> * collegarsi a canali vocali e riprodurre audio * così come tante altre. Troppo estense per essere elencate quì Non può naturalmente leggere i messaggi di canali<ref>Si veda [[Discord]], alla definizione di canale, sottodivisione del "server".</ref> che per questioni di autorizzazione<ref>Si veda [[Discord]], nella sezione riguardante la gerarchia dei ruoli, e i vari permessi.</ref> non possa vedere. Non può neanche leggere il contenuto dei messaggi se gli appositi intenti non sono attivati<ref>{{Cita web\|url=https://discordpy.readthedocs.io/en/stable/intents.html#message-content\|titolo=A Primer to Gateway Intents\|sito=discordpy.readthedocs.io\|lingua=EN\|accesso=2023-10-26}}</ref>. Allo stesso modo, per mancanza di autorizzazione da parte del proprietario<ref>{{Cita web\|url=https://discordpy.readthedocs.io/en/stable/api.html#discord.Guild.owner\|titolo=discord.Guild.owner — API Reference\|sito=discordpy.readthedocs.io\|lingua=EN\|accesso=2023-10-26}}</ref> o dagli amministratori del ~~della~~ guild, il bot potrebbe subire limitazioni nei permessi per eseguire diverse azioni, esse elencate nella [https://discordpy.readthedocs.io/en/stable/api.html#discord.Permissions documentazione dei permessi]. Le autorizzazioni dei singoli Bot sono gestite da [[discord:developers/applications\|Discord Developer Portal]], che genera link di invito al guild per i Bot a seconda dei permessi selezionati. In caso di mancata autorizzazione, l' [[Interprete (informatica)\|interprete]] restituisce un errore. I permessi per ogni particolare guild possono essere sempre modificati dagli amministratori del guild~~. I permessi selezionati sul developer portal non garantiscono che il bot abbia essi permessi~~. === Esempi di codice === Line 51 ⟶ 50: Questo codice crea un semplice bot che quando si esegue il comando '!ciao', lui risponde. Per fare bot più complessi, è suggerito usare la libreria ''discord.ext.commands''<ref>{{Cita web\|url=https://discordpy.readthedocs.io/en/stable/ext/commands/index.html\|titolo=discord.ext.commands – Bot commands framework\|sito=discordpy.readthedocs.io\|lingua=EN\|accesso=2023-10-26}}</ref>, compresa in ogni ~~istallazione~~installazione di discord.py. Esempi più avanzati si possono trovare [https://github.com/Rapptz/discord.py/tree/master/examples sul sito GitHub della libreria].<syntaxhighlight lang="python3" line="1"> # Questo esempio necessita avere l'intento 'message_content' abilitato.