Discord.Net
v3.16.0
La documentación se puede encontrar en https://docs.discordnet.dev/index.html
Discord.Net es un proyecto de código abierto con licencia del MIT y su desarrollo fue posible en su totalidad gracias a voluntarios. Si desea apoyar nuestros esfuerzos financieramente, considere:
Nuestras compilaciones estables están disponibles en NuGet a través del metapaquete Discord.Net:
Los componentes individuales también se pueden instalar desde NuGet:
Ganchos web
Servicios de interacción y comando de texto.
Cobertura API completa.
El núcleo de la API. Implementa solo entidades y funcionalidad básica.
Nightlies son compilaciones de Discord.NET que aún se encuentran en una fase experimental y no se han lanzado.
Están disponibles a través de 2 fuentes diferentes:
Nota
Los paquetes de GitHub requieren autenticación. Puedes encontrar más información aquí.
.NET Core 1.1 no es compatible con WebSockets en Win7 y versiones anteriores. Este problema se solucionó desde el lanzamiento de .NET Core 2.1. Se recomienda apuntar a .NET Core 2.1 o superior para su proyecto si desea ejecutar su bot en plataformas heredadas; Alternativamente, puede optar por instalar el paquete Discord.Net.Providers.WS4Net.
Discord solo admite TLS1.2+ en todos sus sitios web, incluida la API desde el 19/07/2022. .NET Framework no admite este protocolo de forma predeterminada. Si depende de .NET Framework, se sugiere actualizar su proyecto a net6-windows . Este marco admite la mayoría de las funciones exclusivas de Windows introducidas por fx y resuelve errores de inicio debido a la falta de coincidencia del protocolo TLS.
Esta biblioteca generalmente cumple con el control de versiones semántica. Los paquetes se publican en el formato de versión MAJOR.MINOR.PATCH .
Un incremento del componente PATCH siempre indica que se realizó un cambio solo interno, generalmente una corrección de errores. Estos cambios no afectarán la API pública de ninguna manera y siempre se garantiza que serán compatibles con versiones anteriores y posteriores de su código base y cualquier dependencia precompilada de su código base.
Un incremento del componente MENOR indica que se realizó alguna adición a la biblioteca y esta adición no es compatible con versiones anteriores. Sin embargo, Discord.Net no garantiza la compatibilidad futura con adiciones menores. En otras palabras, permitimos un conjunto limitado de cambios importantes en un aumento de versión menor.
Debido a la naturaleza de la API de Discord, muchas veces necesitaremos agregar una propiedad a una entidad para admitir los últimos cambios de la API. Discord.Net proporciona interfaces como método para consumir entidades; y como tal, introducir un nuevo campo en una entidad es técnicamente un cambio radical. Los cambios en las versiones principales generalmente indican algún cambio importante en la biblioteca y, como tal, dudamos en cambiar la versión principal por cada adición menor a la biblioteca. Para llegar a un acuerdo, hemos decidido que las interfaces deben tratarse únicamente como consumibles y, por lo general, sus aplicaciones no deberían implementar interfaces.
Para aplicaciones donde se implementan interfaces, como en simulacros de prueba, nos disculpamos por esta inconsistencia con SemVer.
Si bien nunca romperemos la API (fuera de los cambios de interfaz) en compilaciones menores, ocasionalmente necesitaremos romper la ABI, introduciendo parámetros en un método para hacer coincidir los cambios con Discord. Como tal, un incremento menor de la versión puede requerir que usted vuelva a compilar su código, y es posible que también sea necesario volver a compilar y volver a publicar las dependencias, como los complementos, en la versión más nueva. Cuando se realiza un cambio importante en binario, el cambio se anotará en las notas de la versión.
Un incremento del componente PRINCIPAL indica que se han realizado cambios importantes en la biblioteca; los consumidores deben consultar las notas de la versión para determinar qué cambios deben realizarse.
Liberar rama siguiendo Major.Minor. Tras el lanzamiento, los parches se enviarán a estas ramas. Las nuevas versiones de NuGet se etiquetarán en estas ramas.
Rama de desarrollo, disponible en MyGet. Esta rama es a la que están dirigidas las solicitudes de extracción.
Ramas dirigidas a desarrolladores, agregando nuevas funciones. Siéntase libre de explorar estas ramas y brindar comentarios cuando sea necesario.
Generalmente se dirige a Dev. Estas ramas se utilizan para actualizar la documentación con nuevas funciones o modificaciones de funciones existentes.
