Titel/CD suchen:

Home

Informationen

Download

Developer

Suchen

Statistiken

Hitbase

Newsarchiv

 

(C)opyright 2000-2006 by Big 3 Software, Gebr. Schmitz GbR. Alle Rechte vorbehalten.

 

 

Informationen für Entwickler

Zunächst das wichtigste vorweg: 
Unser CD-Archiv ist offen und frei für alle (Freeware)!

Wir erheben keinerlei Gebühren für die Benutzung unseres CD-Archivs und Sie müssen keinen Vertrag unterzeichnen oder sonstige Verpflichtungen eingehen. Wir versprechen Ihnen außerdem, dass dies auch in Zukunft so bleiben wird!

Falls Sie Entwickler eines CD-Spielers oder eines anderen Programms sind und auf unser CD-Archiv zugreifen möchten, können Sie dies gerne tun. Die einzige Voraussetzung ist, dass Sie uns dies miteilen. Benutzen Sie hierzu das Anmeldeformular. Sie erhalten dann einen Benutzernamen und ein Kennwort, um auf die CD-Datenbank zugreifen zu können.
Außerdem möchten wir die Programmierer bitten, irgendwo im Programm (am besten in der About-Box) einen kleinen Hinweis auf unser CD-Archiv zu geben. Wie gesagt, dies ist keine Pflicht, wir würden uns aber sehr darüber freuen. Wir haben mir der Pflege und Erweiterung des CD-Archivs eine Menge Arbeit, und ich denke, dass ein kleiner Hinweis und/oder eine URL in Ihrem Programm wohl nicht zu viel verlangt ist, oder? :-)

Für ganz Eilige hier ein kurzer Text, der einfach mit "Copy & Paste" übernommen werden kann:

Das CD-Archiv ist ein kostenloser Dienst von Big 3 Software, Gebr. Schmitz GbR.
Weitere Informationen zum CD-Archiv erhalten Sie unter www.cdarchiv.de.

 

Es gibt verschiedene Möglichkeiten, auf das CD-Archiv zuzugreifen.

1. Zugreifen auf das CD-Archiv mit Hilfe der cdarchiv.dll
2. Zugreifen auf das CD-Archiv über manuelle HTTP-Requests


Die CDArchiv.dll

Die CDArchiv.dll bietet eine offene Programmierschnittstelle zum CD-Archiv Server. Hiermit haben Entwickler nunmehr die Möglichkeit, in Ihre eigenen Programme einfach auf eine große Anzahl von CD-Informationen zuzugreifen bzw. selbst neue Informationen (CDs) in das CD-Archiv zu übertragen. Die CDArchiv.dll kann von jeder gängigen Programmiersprache benutzt werden.

Download der CDArchiv.dll Version 1.1 (inkl. Beispielprojekt für MS Visual C++ 6.0)
Dokumentation der CDArchiv.dll Version 1.1

 


Manuelles Zugreifen auf das CD-Archiv

Im folgenden Abschnitt geben wir eine kurze Einführung in die manuelle Benutzung des CD-Archivs. Hiermit haben Sie jedoch nur die Möglichkeit, Informationen aus dem CD-Archiv abzurufen. Neue CDs können nur mit der CDArchiv.dll hinzugefügt werden!

Sie müssen in Ihrem Programm nur einen HTTP-Befehl an unseren Web-Server schicken:

Beispiel (Klicken Sie auf den Link, um die Antwortseite zu sehen!):

http://www.cdarchiv.de/cdquery.asp?User=test&password=test&ID=13433759

Die Parameter User/Password geben an, wer auf das CD-Archiv zugreift. Geben Sie hier den Benutzernamen und das Kennwert an, welches Sie von uns erhalten haben.
Der Parameter ID ist hierbei die Identity (ein eindeutiger Schlüssel), die der Windows CD-Audio-Treiber für die aktuell eingelegte CD erzeugt. Er kann einfach über die entsprechende Windows API-Funktion ausgelesen werden. Hier ein kurzes Beispiel in C:

// Hier das entsprechende CD-ROM Device öffnen!
...
MCI_INFO_PARMS mip;
char szIdentity[20]

memset(&mip, 0, sizeof(mip));
mip.lpstrReturn = szIdentity;
mip.dwRetSize = sizeof(szIdentity);

ret = mciSendCommand(Handle, MCI_INFO, MCI_INFO_MEDIA_IDENTITY, (DWORD)&mip);
// In szIdentity steht nun die Identity der eingelegten CD.
...

Falls Sie nicht mit Windows auf das CD-Archiv zugreifen möchten, finden Sie hier den Algorithmus zum Berechnen der Identity:
Berechnung der CD-Identity

Klicken Sie hier, um ein Beispielprogramm für Visual Basic 6.0 zu laden.

Als Ergebnis erhalten Sie eine HTML-Seite, die Sie in Ihrem Programm interpretieren müssen. Der Aufbau der Antwort-Seite ist sehr einfach gehalten. Trotzdem ist er für zukünftige Erweiterungen offen. Die Antwort-Seite muss zeilenweise eingelesen werden.

Die einzelnen Zeilen haben jeweils die Form:

{Feld}={Inhalt}<br>\r\n

Das "<br>\r\n" ist lediglich für die bessere Lesbarkeit im Browser. Beim Interpretieren des Ergebnisses können bzw. sollten diese Informationen ignoriert werden.

In der folgenden Tabelle werden kurz die Felder aufgelistet, die z.Zt. unterstützt werden.

Feld Typ Bedeutung Beispiel
Version Integer Version des CD-Archivs. Hier steht z.Zt. immer eine 1. Version=1
Date Datum Datum, wann die CD in das CD-Archiv eingefügt wurde (TT.MM.JJJJ HH:MM:SS) Date=12.05.1999 12:23:44
ID String[20] Identity der CD ID=13433759
Artist String[100] Interpret der CD (oder Titel 1 bei CD-Samplern) Artist=Toto
Title String[100] Titel der CD (oder Titel 2 bei CD-Samplern) Title=Fahrenheit
Sampler Boolean =1, wenn es sich bei der CD um einen Sampler handelt. Ansonsten = 0. Sampler=0
TotalLength Integer Gesamtlänge der CD in Millisekunden TotalLength=13433759
NumberOfTracks Integer Anzahl der Lieder auf der CD NumberOfTracks=10
Category String[100] Kategorie der CD (z.B. "Rock/Pop", "Klassik", etc.) Category=Rock/Pop
Media String[50] Medium (z.B. "CD", "CD-Single", "DVD", etc.) Media=CD
Comment String[255] Allgemeiner Kommentar zur CD Comment=1982 aufgenommen
TrackArtist Integer,
String[100]
Interpret des Liedes (nur bei Samplern) TrackArtist=4, "Adams, Bryan"
TrackTitle Integer,
String[100]
Titel des Liedes TrackTitle=4, "Can't stand it any longer"
TrackLength Integer, Integer Länge des Liedes in Millisekunden TrackLength=4, 280001
TrackBPM Integer, Integer BPM des Liedes (Beats per Minute) TrackBPM=4, 90
TrackComment Integer,
String[255]
Allgemeiner Kommentar zum Lied TrackComment=4, "Bestes Lied aller Zeiten"

Die Zahlen in den Klammern des String-Typs geben die maximale Größe dieses Feldes an.

Die meisten Felder sind bei jeder CD gefüllt. Einige Felder (z.B. TrackBPM) werden nur dann zurückgeliefert, wenn dafür Daten vorhanden sind, um den Datentransfer zu verringern. Im allgemeinen sollten alle Felder mit Null initialisiert werden.

Falls Sie weitere Fragen zur Umsetzung haben, können Sie uns gerne schreiben

 

(C)opyright 2000-2005 by Big 3 Software, Gebr. Schmitz GbR. Alle Rechte vorbehalten.
Bei Fragen und Unklarheiten wenden Sie sich bitte an: webmaster@cdarchiv.de.

Stand: 19.04.2009

 

 

Datenbank-Statistik
(23.06.2017 00:00:11)

CDs:

311502

Lieder:

4134519

Interpreten:

287292

CD-Archiv Anmeldung

User:
Password:



Noch nicht registriert?

CD-Archiv
Forum

Haben Sie Fragen zum CD-Archiv? Im Hitbase Benutzerforum gibt es einen eigenen Abschnitt für das CD-Archiv...