Todos los productos
Search
Centro de documentos

IoT Platform:Topic alias

Última actualización: Sep 03, 2026

Los topic alias de MQTT 5.0 sustituyen los topics basados en cadenas por identificadores numéricos. Esto reduce el tamaño de los paquetes y ahorra ancho de banda en dispositivos IoT con recursos limitados.

Contexto

Los dispositivos IoT que se conectan mediante redes celulares suelen ser sensibles al consumo de tráfico y energía. Por ejemplo, los sensores de temperatura alimentados por batería en escenarios agrícolas pueden tener un límite de tráfico mensual de solo unos pocos megabytes. Los paquetes de datos más pequeños ayudan a reducir el consumo de energía y de tráfico. Los topic alias reemplazan las cadenas de topic por números para disminuir el tamaño de los paquetes de mensajes. Una cadena de topic normalmente contiene propiedades de negocio y puede tener decenas de bytes de longitud; en ocasiones, incluso supera al propio payload. Un topic alias sustituye esta cadena por un número que ocupa solo cuatro bytes.

Límites

  • Los topic alias dependen de una asignación entre topics y alias. Tanto el dispositivo como Alibaba Cloud IoT Platform deben mantener esta asignación. La asignación se crea cuando se usa un alias por primera vez y se elimina al cerrar la conexión. El dispositivo debe restablecer la asignación después de reconectarse.

  • Los alias deben ser únicos. Cada topic se asigna a exactamente un alias.

  • No publique mensajes de forma simultánea cuando use topic alias. Dado que la nube tiene una naturaleza distribuida, los mensajes simultáneos podrían perderse.

  • Cada dispositivo admite un máximo de 20 topic alias, tanto para mensajes ascendentes como descendentes.

Escenarios

La figura a continuación usa un sensor de temperatura para mostrar cómo funcionan los topic alias. En este ejemplo, el mensaje A y el mensaje B tienen el mismo payload. El mensaje A incluye tanto un topic como un alias. En el mensaje B, el topic está vacío y se sustituye por el alias. El topic /sys/product_name/device_001/farmland_1234/sensors/temperature tiene más de 60 bytes de longitud. Usar un topic alias permite ahorrar este ancho de banda.imagen..png