Skip to content

FaceStream v.5.1.9#

Summary#

FaceStream changes

  • DROI calculation mechanism was changed.

    Previously, DROI represented coordinates relative to ROI, taking into account image rotation. DROI now represents coordinates relative to the original frame.

  • The FaceStream stream processing report regularly sent to LUNA Streams was expanded with new "last_frame" and "live" fields containing the URLs of the image's last frame and the live stream.

    These URLs can be received using specific requests to the LUNA Streams service (see below).

  • FaceStream operation was accelerated and GPU memory consumption was reduced by limiting the estimation of five landmarks in cases where such estimation is not required.

  • Displaying the IP address of the server running FaceStream was added to the FaceStream logs.

LUNA Streams service changes

  • Migration was added to LUNA Streams, in which all existing streams will be updated in accordance with the new DROI calculation mechanism (see FaceStream changes above).

    When updating FaceStream, it is necessary to update LUNA Streams.

  • A "include_luna_services" parameter was added to "get health" request.

    The "include_luna_services" parameter allows you to enable or disable healthcheck for the LUNA PLATFORM services that the LUNA Streams service depends on. If this option is enabled, then additional requests are sent to the "/healthcheck" resources of these services.

  • Two new resources were added - "get last frame preview" and "get live preview" that allow you to get the values of the "last_frame" and "live" fields from the FaceStream stream processing report (see FaceStream changes above).

    New parameters "preview" > "last_frame" and "preview" > "live" were added to the "get streams logs" request.

  • The automatic restart of the stream now has its own statuses (the "status" parameter).

    The automatic restart statuses are listed below:

    • "disabled" - stream automatic restart is disabled by user ("restart" parameter is disabled)
    • "enabled" -automatic restart is enabled but is not currently active because the stream is not in the "failure" status
    • "in_progress" - automatic restart in progress
    • "failed" - the allowed number of automatic restart attempts was exceeded and none of the attempts were successful
    • "denied" - automatic restart allowed by user, but not possible due to fatal error received in the FaceStream report. At the moment, the critical error has the following content: "Failed to authorize in Luna Platform". In future versions, the list of critical errors may be updated.

    The status of the automatic restart can be obtained using the "get stream" request.

Streams (v.0.4.0 - v.0.5.0)#

Improvements#

  • The DROI calculation mechanism was changed.

    Previously, DROI represented coordinates relative to the ROI, taking into account the rotation of the image.

    From now on, DROI represents coordinates relative to the full frame.

    All existing streams will be updated according to the new DROI calculation mechanism.

  • The live and last_frame stream preview were added.

    See last frame preview and last frame preview for details.

  • The stream autorestart status was added. The stream autorestart mechanism was updated - the fatal error concept was added.

    For more information see autorestart section of get stream response and streams automatic restart.

  • The include_luna_services parameter was added for healthcheck resource.

  • New field preview for stream feedback was added. See stream feedback for details.