Kameraarchiv
Inhalt
In einem Kameraarchiv werden Einzelbilder einer Kamera archiviert. Dargestellt werden diese in der Menü-Maske Kameraarchiv und über die Visualisierung durch Aufruf eines Kameraarchivs.
Die maximale Größe eines Kameraarchivs wird durch die beiden Parameter "Ringspeicher" und "Max Speicher (Bytes)" bestimmt. Der jeweils zuerst erreichte Wert begrenzt die Größe des Archivs.
Die Archive werden remanent gespeichert.

Kameraarchive können über die Globale Bibliothek importiert und exportiert werden.

1.Register

1.1.Daten

Bezeichnung

Unter diesem Begriff wird das Kameraarchiv im HS/FS-Experten geführt.
Über die Endpunkt-Schnittstelle können Kameraarchive gesucht werden, bei denen ein Wort aus der Bezeichnung mit dem dort verwendeten Suchwort beginnt.

Kamera

Hier wird die Kamera zugeordnet. Von dieser Kamera werden durch den Befehl: Kamerabild archivieren die Bilder archiviert.
Das Bildformat im Archiv ergibt sich aus den Abmessungen in der Kameradefinition (Stammdaten/Kamera).

Ringspeicher

Die hier eingetragene Zahl legt die maximale Anzahl von Bildern im Kameraarchiv fest. Ist die Anzahl erreicht, so wird das älteste Bild durch das jeweils neueste ersetzt. Die maximal mögliche Anzahl von Bildern im Ringspeicher, sowohl für ein einzelnes, wie auch für alle Kameraarchive zusammengenommen, beträgt 800.

Max Speicher (Speicher)

Die hier eingegebene Zahl legt den maximal für das Kameraarchiv reservierten Speicherplatz fest. Belegen alle definierten Kameraarchive zusammen zu viel Speicher (mehr als insgesamt 40.000.000 Bytes (~38 MB)), wird beim Prüfen eine Fehlermeldung ausgegeben. Gibt man für ein einzelnes Kameraarchiv einen größeren Wert an, wird die Eingabe in roter Farbe dargestellt.
Ist der hier eingetragene Grenzwert erreicht, so wird das älteste Bild durch das jeweils neueste ersetzt. Ist die hier gemachte Angabe größer als der physikalisch auf dem HS/FS verfügbare Speicher, wird der physikalisch verfügbare Speicher als Grenze verwendet und die hier gemachte Angabe ignoriert.
Hinweis
Reicht der Speicher des HS/FS nicht mehr aus, um den Remanentspeicher zyklisch zu sichern, werden Bilder aus Kameraarchiven entfernt um Platz zu schaffen. Näheres dazu siehe Remanent-Speicher, Kapitel Abschneiden.

Max Speicher (Einheit)

Hier kann die Einheit für den Wert des MaxSpeichers festgelegt werden. Zur Auswahl stehen:
  • Bytes
  • KB (1 KB = 1024 Bytes)
  • MB (1 MB = 1024 KB)
Hinweis
Zu beachten ist, dass der eingegebene Wert vom Programm nicht automatisch neu berechnet wird, wenn man die Einheit ändert!

Totzeit (Sekunden)

Nachdem ein Bild archiviert wurde, muss die hier angegebene Zeit verstreichen, bevor ein weiteres Bild archiviert werden kann.

1.2.Endpunkt

Auf Kameraarchive kann über die Endpunkte-Schnittstelle des HS/FS zugegriffen werden.
Eine Beschreibung der Aufruf-Parameter gibt es hier.
Hinweis
Anstelle des in allen Aufruf-Beispielen in der folgenden Tabelle eingesetzten Kameraarchivs, kann natürlich jedes beliebige Kameraarchiv verwendet werden.

Platzhalter sind in GROSSBUCHSTABEN angegeben.

1.2.1.Methoden

MethodeBeschreibung/Aufruf
metaAbruf von Meta-Daten des Kameraarchivs.
https://HS_IP/endpoints/call?key=CA@my_camarch&method=meta&user=USER&pw=PWD
get_listAbruf einer Liste der Einträge eines Kameraarchivs.
https://HS_IP/endpoints/call?key=CA@my_camarch&method=get_list&user=USER&pw=PWD
get_pictureAbruf eines Bildes (als JSON, base64-kodiert) aus einem Kameraarchiv unter Angabe der Bild-ID (geliefert von get_list).
https://HS_IP/endpoints/call?key=CA@my_camarch&method=get_picture&pic_id=4711&user=USER&pw=PWD
get_picture_rawAbruf eines Bildes (als Binär-Blob, z.B. als JPEG) aus einem Kameraarchiv unter Angabe der Bild-ID (geliefert von get_list).
https://HS_IP/endpoints/call?key=CA@my_camarch&method=get_picture_raw&pic_id=4711&user=USER&pw=PWD

1.2.2.Felder

ID
Der hier eingegebene Wert bildet zusammen mit dem fest vorgegebenen Präfix "CA", mit dem die ID durch ein '@'-Zeichen verbunden ist, den eindeutigen Objekt-Schlüssel des Endpunkts.
Erlaubte Zeichen sind: A-Z, a-z, 0-9, Bindestrich ("-") und Unterstrich ("_")!
Beschreibung
Eine sprechende Beschreibung des Kameraarchivs.
Über die Endpunkt-Schnittstelle können Kameraarchive gesucht werden, bei denen ein Wort aus der Beschreibung mit dem dort verwendeten Suchwort beginnt.
Tags
Eine Liste von Begriffen, getrennt durch Kommata (",").
Über die Endpunkt-Schnittstelle können Kameraarchive gesucht werden, bei denen ein einzelner Tag vollständig mit dem dort verwendeten Suchwort übereinstimmt.
Erlaubte Zeichen sind: A-Z, a-z, 0-9, Bindestrich ("-") und Unterstrich ("_")!
Benutzergruppen
Achtung
Dieser Punkt ist nur verfügbar, wenn Benutzergruppen aktiviert wurden!
Benutzergruppen können berechtigt werden, über die Endpunkte-Schnittstelle auf dieses Kameraarchiv (zum Lesen) zuzugreifen.