Request for comments: Plugin-Interface für DLNA-Plugin

Das mit den "Erzeugen der Resourcen" habe ich mir auch gedacht beim Kontrollesen, "Erzeugen von Referencen auf die Resourcen".

So ich habe nun folgendes Problem, was passiert wenn Recourcen gelöscht werden?
Auch finde ich nur eine Funktion für "das sich ein Container geändert hat".
Schmeisst dann der Manager den kompletten Container weg und liest den komplett wieder ein?

Desweiteren fehlt mir die Seek Funktion.

Johns

Das Problem hättest du nicht, wenn das Plugin, also der Manager scannen würde.

Ich würde die UpdateId eine Property für jede Recource machen.
Dann würde aus OnContainerUpdate OnRecourceUpdate werden.
Wenn jetzt ein Modul nur mit Container arbeiten kann, dann ruft es einfach die
OnRecourceUpdate mit dem Container auf.

Also wenn ich jetzt mal von mp3 in einem Filesystem ausgehen würde.
Dann sollte ich für jedes mp3 die Metadaten (Author, Titel usw.) aus dem
mp3 extraieren.

Für den Scan im Modul brauche ich die Funktionen:

• Alle Recourcen Referencen in dem Container
  Damit ich gelöschte Recourcen aufräumen kann.
• Hole die UpdateId der Recource
  Damit ich mir nur bei Änderung die Metadaten hole.
• Lösche eine Recource Reference
  Damit ich gelöschte Recourecen aktualisieren kann.
• Update und Einfügen einer Recource Reference mit Metadaten

Ich persöhnlich würde nur Update+Einfügen incl aller Metadaten als API zur Verfügung stellen.
Irgendwie finde ich die Funktion um Recource Referencen anzulegen nicht.

GetContainerEntries(Uri)
GetUpdateId(Uri)
DeleteRecource(Uri)
UpdateRecource(Uri, UpdateId, PropertyList)

Johns

Hallo,

ich habe mal ein kleines Datenmodell gepinselt, welches unabhängig der Schnittstellen Specs ist und aus dem trotzdem alle Objekte erzeugt werden könnten.
Weiß nicht, ob das Plugin auch Dateien anbieten soll, die nicht vom VDR stammen.
Falls dem so ist, wäre mediainfo ein gutes Werkzeug zur Medienanalyse.
Es liest Metatags aus audio-Dateien, liefert Informationen zu Bildern und natürlich stream-infos für alle Bestandteile eines Video.
Funktioniert auch für VDR-Dateien.

Den container habe ich optional gemacht, da ich es für wenig sinnvoll halte, die ganze Dateisystem-Struktur in der Datenbank zu duplizieren. Andererseits gibt es Situationen, in denen der Container sinnvoll wäre, wie z.B. ein Album bei Musikstücken oder wenn Bilder nach Urlaub/Veranstaltung gruppiert sind, dann möchte man evtl. danach suchen.
Ansonsten halte ich den Einstieg über Genre bzw. Person/Rolle eher für anwenderfreundlich.
Wenn man in der Datenbank einen Änderungszähler führt, kann man aus den Personen und Genres virtuelle Container machen, die dann den Zugriff auf die Medien ermöglichen.

Die Tabelle mediainfo ist die Basisklasse, die jeweils die Informationen für einen Stream aufnimmt. Da mediainfo immer auch Informationen zum Mediencontainer ausgibt, sind es selbst bei einem Bild 2 Einträge in mediainfo. Die Tabelle enthält die geläufigsten Attribute. Alle weiteren Attribute werden als Tag abgelegt.

So könnte die Schnittstelle für Module auf ein "setTag" reduziert werden und die mediainfo-Instanz entscheidet selbst, wo was abgelegt wird.
Die Tabelle mediainfo wäre auch ein gutes Hilfsmittel, falls mal recodierung ein Thema werden sollte.

Neben dem Bild habe ich noch die Datei für mysql-workbench hochgeladen. Die Datenbank ist nicht vollständig - eher ein Denkanstoß.
Mit der Workbench können einfach die SQL-Scripte erzeugt werden. Mit ein paar Anpassungen (fals nötig) wären die dann auch für sqlite zu gebrauchen.

Gruß Gero

Zitat von methodus

Die Problematik, die ich die ganze Zeit aber hatte ist, dass der Plugin-Manager keine Kenntnis darüber hat, ob und wann eine Resource geupdatet wurde. Außerdem werden UpdateIDs nur für Container gepflegt. Es gibt keine UpdateID für eine Datei selbst. Wenn eine Resource gelöscht wird, ändert sich die UpdateID des Elterncontainers.

Ok. Also doch anders herum.
Ich würde den Scanner nicht die Metadaten zurückgeben lassen.
Sondern einfach eine Property Liste und UpdateID.
Und ich würde jedem Object egal ob Container oder Recource eine UpdateID geben.

Und aktuallisieren würde ich immer wenn UpdateID != der gespeicherten ist.

Dann braucht es noch Thumbnails bzw. Icons?

So einmal durchspielen:

Der Manager ruft das Modul mit dem Rootverzeichnis der MP3 Musik auf.
Hier kann mehrere Wege gehen, ich mache mal den Einfachen fürs Modul.
Der Manager prüft mit GetContainerUpdateId ob es sich verändert hat.
Wenn ja: GetContainerEntries gibt alle Unterverzeichnisse und MP3 in diesem zurück.
Alle MP3 werden auf Änderung abgefragt und mit GetMetadata diese geholt.
Nicht mehr vorhanden Recourcereferenzen werden gelöscht.
Recursiv wird dies für alle Unterverzeichnisse wiederholt.
Wenn nein: Wird dies recursiv für alle Unterverzeichnisse wiederholt.

Nebenbei legt das Modul eine Überwachung aller Datein und Verzeichnisse an.
Wenn irgendwas verändert wird dies über OnContainerUpdate mitgeteilt.

Johns

Ich meinte nicht die Struktur oder Class Metadata aus deinem Headerfile zurückgibt.
Sondern eine Property Liste oder Tabelle aus Schlüsselwort und Wert.

Damit ist das Modul unabhängiger vom Manager, man braucht keine Setter und Getter definieren usw.

Der Manager arbeitet dann die Liste ab und wandelt die dann wenn gewünscht um.

Dann brauchst du noch eine GetIcon bzw. GetThumbnail Funktion.

Johns

Zitat

Das würde dann aber nur die Schnittstelle zum User-Frontend bedeuten, wenn ich alles auf SetTag festlegen würde.

Nein, nicht zum User-Frontend, sondern zu den Modulen, die Dir die Medien bzw. Metadaten liefern.
Johns hat es verstanden und Dir anders erklären können.

Zitat

Container, oder in deiner Definition Tags

Nö - das ist ein Mistverständnis.

Tags sind keine Container, sondern benannte Variablen mit einem Inhalt.
Diese Variablen können Bezug zum Medium an sich (dem Mediumcontainer als TS oder MKV) haben, oder zu einem einzelnen Stream.
Auch die ganzen MP3-Tags lassen sich dort ablegen.
Ferner kann man die Tags auch verwenden um Stream-Attribute abzulegen, die eher seltener vorkommen, dann aber doch von Interesse sind.

Zitat

Was mir an der Struktur nicht wirklich gefällt, dass sie - was aus deiner Sicht genau so geplant wurde - komplett vom Standard weg geht.

Das habe ich schon wiederholt versucht rüber zu bringen:
Der Standard definiert den Datenaustausch zwischen unterschiedlichen Systemen, aber nicht deren internen Aufbau.

Nimm z.B. SAP - die Software kann eine Vielzahl von Schnittstellenstandards bedienen, aber kein Schnittstellenstandard beeinflusst den internen Aufbau.

Dein Datenmodell sollte sich daran orientieren, was Du an Daten hast. Also Deine Medien, Deine Metadaten, was auch immer.
Dann solltest Du überlegen, welche Daten in eine Datenbank müssen und welche eher nicht.
Erst danach solltest Du Dir Gedanken machen, wie Du die Schnittstelle befriedigen kannst.
Schließlich machst Du kein Renderer-Device, das von den Daten anderer leben muss, sondern ein ContentDirectory-Device, welches Daten liefert.
Deine Daten!

Schreib doch einfach mal ein Testproggy, welches Dir die Daten zusammenträgt, die Du veröffentlichen willst - und zwar ohne nach der Schnittstelle zu schielen.
Dann weißt Du, wie Du an die Daten kommst, weißt auch, welche Daten Du hast und kannst dann überlegen, wie Du weiter machen willst.

Zitat

Das macht die spätere Erweiterung und Aktuallisierung an Folgereleases der Standards schwieriger.

Ganz im Gegenteil. Wenn Du zwischen internem Aufbau und Schnittstelle zu extenern Systemen unterscheidest, kannst Du viel flexibler auf Änderungen eingehen.
Teile Dein Plugin gedanklich mal in Bausteine auf, denen Du Funktionalitäten und Verantwortlichkeiten zuordnest.
Versuch dabei so vorzugehen, dass ein Baustein möglichst autark ist, d.h. so wenig wie möglich von anderen Bausteinen braucht.
Dort wo Berührungspunkte unvermeidlich sind, sorge für eine klare Schnittstelle.
So kannst Du die Komplexität der Aufgaben reduzieren und für eine stabilere Basis sorgen.

Zitat

... warum eine Property nur 45 oder 255 Zeichen statt 1024

Die Schnittstelle sagt nur, dass max. 1024 Zeichen erlaubt sind. Das bedeutet nicht, dass es immer 1024 Zeichen sein müssen.

255 ist deshalb eine "magische" Grenze, weil bei vielen Datenbanken Felder bis 255 Zeichen Länge als interne Tabellenspalte behandelt werden. Über 255 Zeichen wird implizit ein Blob draus, der dann nicht mehr indiziert werden kann und einen Extra-Zugriff erfordert. Textfelder > 255 Zeichen machen den Datenzugriff langsamer - deshalb versucht jeder DB-Admin mit 255 Zeichen auszukommen, so lange es geht.
Manchmal muss es trotzdem sein, dass man ein größeres Feld nimmt, aber das sollte wie gesagt gut überlegt sein.

Zitat

Die Entwickler sollen sich, wenn sie eine Erweiterung schreiben, ruhig mit dem Werk mal auseinander setzen, um zu begreifen, wie es funktioniert

Hm, jetzt forderst Du etwas, was Du selbst nicht bereit bist zu tun?!?
Du schnitzt ein Plugin für den VDR und bist nicht bereit, Dir anzuschauen, was der VDR bietet und warum er so ist wie er ist.

Zitat

Das ist meiner Meinung nach einer der Hauptgründe, warum viele UPnP/DLNA-Server/-Client-Kombinationen nicht funktionieren.

Ich würde behaupten, dass es eher daran liegt, dass viele von der Schnittstellen-Definition ausgehen, ohne zu sehen, was sie wirklich ist, nämlich eine Schnittstellen-Definition.

Zitat

GetProperty("Title").GetString() bzw. GetInteger() oder GetBoolean().

Das halte ich für suboptimal. Sowohl von der Lesbarkeit, als auch von der Laufzeit.
Ein Funktionsaufruf ist prinzipiell als teuer einzustufen, deshalb nicht unnötig viele machen.
Das gleiche kannst Du erreichen, mit

GetStringProperty("Title")
GetIntegerProperty("total")

ist lesbarer und spart einen Funktionsaufruf.

Gruß Gero

Wie andere vorher schon geschrieben haben. Halte ich auch nicht viel von großen Tests,
aber einfache Abschätzungen können helfen. Einmal 100000 Properties anlegen und darin suchen helfen beim Überlegen.
Diese Tests sollten einfache 3 Zeiler sein. Bzw. können gleich dein Datenbank Modul testen.

Also ich würde für ein Scanner Modul keine Property Klasse brauchen.
Auch kein GetString usw. . Aber schaden tut es auch nicht.

Für Pflichtproperties kann man auch anders herum arbeiten.

z.b.:

property_list = NewPicturePropertyList("Name", 1024, 768);
Add("Aufnahme Datum", date);

NewPicturePropertyList erzeugt die Leere Property Liste und fügt dann die ersten Elemente in Liste.

Ansonsten lass dich von uns nicht mehr lange aufhalten, schreibe den Manager.

Johns

Zitat

Halte ich auch nicht viel von großen Tests,
aber einfache Abschätzungen können helfen.

Hm, also das halte ich für einen großen Irrtum.

Wie willst Du Abschätzungen machen, wenn Du keine Zeitbasis hast?

Als ich mit CMP anfing habe ich auch über alle möglichen Datenstrukturen und Zugriffszeiten nachgedacht.
Dann habe ich ein kleines Testproggy geschrieben, dass mit VDR-Mitteln die EPG-Daten einliest - erweitert um eine Zugriffssuche nach einem nicht vorhandenen Schlüssel.
Das waren vielleicht 10 Zeilen Code.
Aber die haben mir die Augen geöffnet.
Ich bin mir sicher, dass manche hier anders diskutieren würden, wenn sie mehr Messungen machen würden.

Zitat

Also lieber Gero, mach mir ein Testprogramm ...

Lach - und wovon träumst Du nachts?

Meine (Test-)Proggies laufen bereits. Sogar mit benchmarking - aber Du bist ja nicht bereit die anzuschauen.
Der Datenscanner mit Datenbank ist Teil von VdrAssistant und befüllt eine mysql-Datenbank. Läuft inzwischen seit eingen Jahren.
Der Datenscanner ohne Datenbank ist der Serverpart (cmps) von CMP und lädt beim Start direkt alle Medien vom Dateisystem.
Von beiden Anwendungen sind die Quältexte veröffentlicht, es steht Dir also frei, dort mal stöbern zu gehen.

Den Tip ein Testproggy zu schreiben habe ich Dir nur gegeben, damit Du ein Gefühl für die Materie bekommst, über die Du hier diskutierst.
Der Sinn eines Testproggies oder auch Prototypen ist der, dass man sich auf einen Aspekt konzentriert und alles andere ausblendet. Wenn's dann tut, kann man den Code in finale KLassen transferieren, verliert also nix.
Prototyping ist "eigentlich" die Grundlage von jedem ernsthaften Software-Projekt, denn erst wenn man Messungen eines Prototypen hat, kann man seriöse Abschätzungen machen. Aber wenn Du meinst, sowas nicht zu brauchen ...

Gruß Gero

Ich kann Toshiba TV und Xbox Client testen.
Zur Not bastel ich den Bilderscanner, ich denke ich muß, die Metadaten auslesen,
sowieso in mein Play Plugin einbauen.

Johns