Copyright © 2005-2018 MultiMedia Soft

Files to be included with your application

Previous pageReturn to chapter overviewNext page

 

Important note about installed version

 

This section of the documentation applies to the full purchased version only: the trial version of the component comes with an internal protection schema against fraudulent uses which will block most functionalities when the component is redistributed outside of the development machine where the trial version was originally installed through the provided setup program.

 

 

Files that you need to redistribute with your application depend upon the platform target:

 

If compiling for "Any CPU"

  - the class assembly

AudioDjStudioApi.dll if your application was targeted for .NET framework 2.0, 3.0 or 3.5 and the reference to AudioDjStudioApi was used inside the project

AudioDjStudioApiF4.dll if your application was targeted for .NET framework 4.0 or higher and the reference to AudioDjStudioApiF4 was used inside the project

  - the x86 version of the multimedia engine AdjMmsEng.dll

  - the x64 version of the multimedia engine AdjMmsEng64.dll

 

If compiling specifically for x86

  - the class assembly

AudioDjStudioApi.dll if your application was targeted for .NET framework 2.0, 3.0 or 3.5 and the reference to AudioDjStudioApi was used inside the project

AudioDjStudioApiF4.dll if your application was targeted for .NET framework 4.0 or higher and the reference to AudioDjStudioApiF4 was used inside the project

  - the x86 version of the multimedia engine AdjMmsEng.dll

 

If compiling specifically for x64

  - the class assembly

AudioDjStudioApi.dll if your application was targeted for .NET framework 2.0, 3.0 or 3.5 and the reference to AudioDjStudioApi was used inside the project

AudioDjStudioApiF4.dll if your application was targeted for .NET framework 4.0 or higher and the reference to AudioDjStudioApiF4 was used inside the project

  - the x64 version of the multimedia engine AdjMmsEng64.dll

 

You can find redistributable files mentioned above inside the folder in which you installed Audio DJ Studio API for .NET (default "C:\Program Files\Audio DJ Studio API for .NET\Redist").

DirectX version 9.0c or higher should be available as well. DirectX redistributable modules can be obtained from the Microsoft web site.

 

 

Important note about the folder chosen for installing our files

 

In order to avoid the "DLL Hell" problem, it's strongly recommended that you install the mentioned files into the same folder in which you will install the EXE of your container application on the target system and not inside the Windows\System32 or Windows\SysWOW64 folders.

 

 

 

Important note about usage of the API through COM interoperability

 

If you are going to use the API with legacy development environments like Visual Basic 6 or unmanaged Visual C++, which can talk to the API through COM interoperability, during redistribution on target machines you need to register the API assembly on the target system registry through the RegAsm.exe utility provided by Microsoft.

It's very important to remember that there are two versions of RegAsm.exe, one for assemblies compiled against version 2 of the .NET framework and one for assemblies compiled against version 4 of the .NET framework. You can locate the appropriate version of the RegAsm.exe utility inside your system using the following schema:

 

.NET framework

version

RegAsm.exe default installation path on your development system

Assembly to register

 

 

 

2.0 / 3.0 / 3.5

C:\Windows\Microsoft.NET\Framework\v2.0.50727\RegAsm.exe

AudioDjStudioApi.dll

4.0 and higher

C:\Windows\Microsoft.NET\Framework\v4.0.30319\RegAsm.exe

AudioDjStudioApiF4.dll

 

 

 

Special notes

 

If you need dealing with Windows Media Audio files (WMA, ASF, WMV, etc.), the Microsoft Windows Media Format modules must already be installed on the target PC: for Windows XP and previous versions the Windows Media Format modules can be installed using the redistribution setup package (wmfdist.exe) provided by Microsoft. For Windows Vista and later versions there is the need to install the Microsoft's Windows Media Player application (which is usually installed by default).

 

For using the API as a source for SHOUTCast or IceCast servers, the following command line encoders must be available on the target system:

- Lame.exe encoder for casting in MP3 format.

- OggEnc.exe encoder for casting in OGG Vorbis format.

- FdkAac.exe encoder for casting in AAC+ format.

 

 

How to create a "ClickOnce" setup containing our component using Visual Studio .NET

 

Inside the "Solution Explorer" open "References"
Locate and select the reference to AudioDjStudioApi
Inside the "Properties" window locate the "Copy Local" property and set it to "True"

 

Inside the "Solution Explorer" right-click the project name
From the context menu select "Properties..."
Select the "Publish" tab
Click the "Application Files..." button
For the AudioDjStudioApi.dll (or AudioDjStudioApiF4.dll) assembly, verify that inside the "Publish status" column the default "Include" option is selected

 

Inside the "Solution Explorer" right-click the project name
From the context menu select "Add\Existing Item..."
Inside the "Objects of type" combobox select "Executable files"
Locate the directory where AdjMmsEng.dll and AdjMmsEng64.dll are installed (by default should be under "C:\Program Files\Audio DJ Studio API for .NET\Redist")
Select AdjMmsEng.dll and AdjMmsEng64.dll and press the "Add" button
for both of them change the "Copy to Output Directory" property to "Copy always"
Rebuild the ClickOnce package