MindBlast SoftwareMindBlast Software  

Home  Components  Order now!  News  Contact  About 

Last updated: 02 May 2002


TMBSTransparentForm

.: MBS MP3Remote - Quick Start Guide

.: Overview

This guide is meant to teach you the basics you need to know to control Winamp. It starts with some basic topics moving on to some more advanced techniques. It is highly recommended you read the complete document.

.: 0 :. Contents

  1. Getting ready to control Winamp
  2. Basic functions
  3. Troubleshooting

.: 1 :. Getting ready to control Winamp

Ok...so you installed the package into Delphi and you are now ready to create your first application.

Before you can control Winamp 2 things need to happen:
a) Winamp must be running
b) We need to create a "connection" to Winamp. (We need to find the window handle of Winamp)

So lets first complete this phase of the application...

  • Create a new application
  • Put a single TMP3Remote on a form and name it Remote
  • Now put a button on the form &  give it the caption "Initialize"

Now in the button's OnClick event handler type this:

procedure TForm1.Button1Click(Sender: TObject);
begin
  if not Remote.FindWinamp then
    if not Remote.StartWinampAndWait then
      ShowMessage('Unable to load Winamp!');
end;

Now run the application - if Winamp is not already running clicking on the button will load Winamp, else clicking on the button will simply create the "connection" needed by MP3Remote. This is all that is needed to start using MP3Remote. You can now simply call the rest of the functions like Remote.Play or Remote.Next to execute those actions in Winamp.

.: 2 :. Basic functions

Please refer to the demo application to see how some of the basic functions of the component is used.

.: 3 :. Troubleshooting

Here follows some general problems and how to solve them. Feel free to contact us if you are still having trouble after reading this.

  • Problem: When I compile my application I get the error message that some ".dcu" file is not found?
    Solution: You need to add the path where the *.pas or *.dcu files of the package is located to your library search path. Follow the install instructions step-by-step to solve this problem.
  • Problem: None of the functions of MP3Remote wants to work?
    Solution: Did you follow the instructions in step 1 of this guide? You probably need to create  the connection to Winamp first...
  • Problem: Some of the functions of MP3Remote does not want to work?
    Solution: This can be becauses ome functions only works from within a Winamp plugin dll. If you are using these funcions from within a plugin DLL make sure you set the DLLmode property to true. Also make sure you have a Winamp version later than v2.60.

(c) Copyright MindBlast Software, 1998 - 2002.
This site is partly powered by PHPNuke templates.