CDDB Component
Introduction
User GuideObject Model
Technical Reference
Code Example
Download
Buy a License
Other Volto Components
|
When using this component to create applications with Visual Basic, you must declare a reference to the
VoltoCDX component. Create a new project in Visual Basic, choose Project References (ALT, P, N) and in
the list of Available References make sure that the entry entitled Volto CDDB Component is selected
(i.e. checked). When using a licensed component, you should first call the ProductLicense method in
order to unlock full product functionality. See the Technical Reference
for more information. Also see the online code example for a
practical example of component usage.
How to retrieve valid CD drive letters: The Drives property is a collection of all valid CD drive letters on the local computer. A list of drive letters can be obtained by iterating through the collection. How to retrieve track and CD timings: Call the GetData method specifying the modeCDLocal mode and the drive letter of the drive containing the audio CD. The CDs collection property will now contain a single CD object whose Length property contains the CD length in seconds. The CD object's Tracks property will contain a collection of Track objects - each object representing a single track on the CD. By iterating through this collection, the length of each track can be found in the Length property of the specified Track object. How to retrieve CD titles from freedb.org: Call the GetData method specifying the modeCD mode and the drive letter of the drive containing an audio CD. The component will now recognise the CD and connect via the internet to the CDDB database server. Note that if your internet connection requires a proxy server, you will need to define this using the ServerSettings method. More than one matching record may be found as the same CD may be registered under multiple genres, for example. The CDs property contains a collection of CD objects - each CD object corresponding to a database record. The CD objects in the collection have properties for information about the CD (e.g: Title, Length, Artist, Genre, CDDBid etc). How to retrieve track titles from freedb.org: Retrieve CD data as described above. Each CD object's Tracks property is a collection of Track objects - each Track object corresponding to one track on the CD. Track objects have properties for information about each track (e.g: Title, Length etc). How to retrieve data from a local database file: A local database directory structure consists of a root directory beneath which subdirectories exist for each genre (subdirectory names correspond to the genre names). The actual database files are located beneath the appropriate genre subdirectory. Call the GetData method specifying the modeGenreCDDBID mode, the genre name, the CD id and the local database root directory path. If a matching database record is found, the CDs and Tracks collections will be filled with data and their properties can be read as described above. How to submit data to freedb.org: Create a new CD object. Create a new Track object for each track. Set the required properties of the CD and Track objects and then add each Track object to the Tracks collection property of the CD object. Alternatively, instead of creating new objects, simply update properties of existing objects following a query to the CDDB database. To submit data, call the SubmitData object passing a CD object as a parameter. Note: an example of how to use the SubmitData method is given in the demo program included when you install the component. Distributing the Component When you purchase a license for this component, you will be provided with a serial number, a license key and a redistributable runtime license file. As a licensed user you may distribute the component with your compiled applications royalty-free. To ensure that your application will function correctly on a target system, your program must call the ProductLicense method to unlock licensed functionality. See the Technical Reference for more information on using this method. Your application setup package must copy the component and the runtime license file to the same directory and the component must be registered. Also ensure that the Visual Basic 6.0 runtime files are installed on the target system. These files (and minimum version numbers) are:
|