Subscribe Metadata by Type

Subscribe Metadata by Type

You can specify the metadata type (supports type combination) to subscribe the required metadata details, and the details are returned in URI format over RTSP (Real-Time Streaming Protocol).

Figure 1. API Calling Flow of Subscribe Metadata by Type

  1. Call /ISAPI/Streaming/channels/<ID>/metadata/capabilitiesby GET method to get the metadata configuration capability.

    The capability is returned in the message XML_Cap_MetadataCfg.

  2. Check whether the device supports subscribing metadata by type.

    • When the node <isSupportSubscribeType> is returned in the message XML_Cap_MetadataCfg, it indicates that the device supports metadata subscription and you can continue to perform the following steps.

    • When the message XML_Cap_MetadataCfg does not contain node <isSupportSubscribeType>, it indicates that the device does not support metadata subscription and please end this task.

  3. Optional: Call /ISAPI/Streaming/channels/<ID>/metadata by GET method to get the metadata types that are supported to be subscribed.
  4. Call /ISAPI/Streaming/channels/<ID>/metadata/subscribeType?format=json by POST method to specify metadata type to be subscribed and get the crooesponding metadata details URI.

Subscribe Metadata by Type

You can specify the metadata type (supports type combination) to subscribe the required metadata details, and the details are returned in URI format over RTSP (Real-Time Streaming Protocol).

Figure 1. API Calling Flow of Subscribe Metadata by Type

  1. Call /ISAPI/Streaming/channels/<ID>/metadata/capabilitiesby GET method to get the metadata configuration capability.

    The capability is returned in the message XML_Cap_MetadataCfg.

  2. Check whether the device supports subscribing metadata by type.

    • When the node <isSupportSubscribeType> is returned in the message XML_Cap_MetadataCfg, it indicates that the device supports metadata subscription and you can continue to perform the following steps.

    • When the message XML_Cap_MetadataCfg does not contain node <isSupportSubscribeType>, it indicates that the device does not support metadata subscription and please end this task.

  3. Optional: Call /ISAPI/Streaming/channels/<ID>/metadata by GET method to get the metadata types that are supported to be subscribed.
  4. Call /ISAPI/Streaming/channels/<ID>/metadata/subscribeType?format=json by POST method to specify metadata type to be subscribed and get the crooesponding metadata details URI.