Gestión de eventos

La gestión de eventos es un proceso que se puede dividir en dos partes:

• agregar los elementos necesarios a la sesión, indicando los tipos de eventos necesarios;
• recibir y procesar los eventos.

Para obtener eventos de los elementos, debe agregar estos elementos a la sesión con el método core/update_data_flags.

Hay tres formas de agregar elementos a la sesión:

• por tipo;
• por ID;
• por lista de ID.

Ejemplo 1

Agreguemos a la sesión tres unidades: Bavarian Tractor, Alabama y Touareg. Sus ID son conocidos, por lo que agregamos estas unidades indicando el valor col para el parámetro type:

https://hst-api.wialon.com/wialon/ajax.html?
svc=core/update_data_flags&
params={
  "spec": [
    {
      "type": "col",
      "data": [34868, 22800, 553632],
      "flags": 1,
      "mode": 0
    }
  ]
}&
sid=<your_sid>

Como solo está establecido el flag básico, podremos obtener eventos únicamente sobre el cambio de nombre de estas unidades.

Como el valor del parámetro mode es 0, todos los flags anteriores del elemento se reemplazan por los de la solicitud.

Respuesta:

[
  {
    "i": 34868,
    "d": {
      "nm": "Bavarian Tractor",
      "cls": 2,
      "id": 34868,
      "mu": 0,
      "uacl": 880333094911
    },
    "f": 1
  },
  {
    "i": 22800,
    "d": {
      "nm": "Alabama",
      "cls": 2,
      "id": 22800,
      "mu": 0,
      "uacl": 880333094911
    },
    "f": 1
  },
  {
    "i": 553632,
    "d": {
      "nm": "Touareg",
      "cls": 2,
      "id": 553632,
      "mu": 0,
      "uacl": 880333094911
    },
    "f": 1
  }
]

Ejemplo 2

Si ya no necesita obtener eventos de la unidad Touareg, puede eliminarla de la sesión. Como la eliminación se aplica solo a una unidad, indique el valor id para el parámetro type en la solicitud.

https://hst-api.wialon.com/wialon/ajax.html?
svc=core/update_data_flags&
params={
  "spec": [
    {
      "type": "id",
      "data": 553632,
      "flags": 1,
      "mode": 2   /* eliminación del flag */
    }
  ]
}&
sid=<your_sid>

Para eliminar completamente una unidad de la sesión, establezca el valor 1 para el parámetro flags. Solo puede dejar de recibir todos los mensajes de una unidad si solicita explícitamente la eliminación del flag básico.

Por ejemplo, si inicialmente agregó una unidad con el flag 3 (que combina los flags 1 y 2) y después elimina solo el flag 2, el flag 1 seguirá activo. Como resultado, dejará de recibir los eventos asociados al flag 2, pero seguirá recibiendo los eventos asociados al flag 1.

Respuesta:

[
  {
    "i": 553632,
    "d": null,
    "f": 0
  }
]

El valor 0 en el campo f confirma que la unidad se eliminó correctamente de la sesión.