Files to be included with your application |
|
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.
|
The component's assembly that you need to redistribute with your application depend upon the target .NET platform:
• | for .NET framework 2.0, 3.0 or 3.5 with reference to AudioDjStudio used inside the project (*) |
- AudioDjStudio.dll
• | for .NET framework 4.0 or higher with reference to AudioDjStudioF4 used inside the project (*) |
- AudioDjStudioF4.dll
• | for .NET 5 with reference to AudioDjStudioF5 used inside the project |
- AudioDjStudioF5.dll
• | for .NET 6 with reference to AudioDjStudioF6 used inside the project |
- AudioDjStudioF6.dll
• | for .NET Core 3.1 with reference to AudioDjStudioCore3 used inside the project |
- AudioDjStudioCore3.dll
All of the mentioned assemblies work as wrappers for the multimedia engine whose binary file must be redistributed as well:
• | If compiling for "Any CPU" |
- the x86 version of the multimedia engine AdjMmsEng.dll
- the x64 version of the multimedia engine AdjMmsEng64.dll
• | If compiling specifically for x86 |
- the x86 version of the multimedia engine AdjMmsEng.dll
• | If compiling specifically for x64 |
- the x64 version of the multimedia engine AdjMmsEng64.dll
You can find redistributable files mentioned above inside the folder in which you installed the Audio DJ Studio for .NET component, whose default can be one of the followings:
• | If it was installed as stand-alone: \Program Files\MultiMedia Soft\Audio DJ Studio for .NET\Redist |
• | If it was installed through Audio Sound Suite for .NET: \Program Files\MultiMedia Soft\Audio Sound Suite for .NET\Audio DJ Studio for .NET\Redist |
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.
|
DirectX version 9.0c or higher should be available as well. DirectX redistributable modules can be obtained from the Microsoft web site.
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 component 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.
• | For exporting contents of the TracksBoard session into an output audio file in AAC+ format the FdkAac.exe encoder must be available on the target system |
• | For exporting contents of the TracksBoard session into an output audio file in AAC/MP4 format the Faac.exe encoder must be available on the target system |
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 AudioDjStudio |
• | 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 AudioDjStudio.dll (or AudioDjStudioF4.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 "\Program Files\MultiMedia Soft\Audio DJ Studio 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 |
(*) Projects originally developed with versions of the components older than 7.3 always use AudioDjStudio reference: if you want to develop an application that can run directly into a Windows system where versions 2.0, 3.0 or 3.5 are not installed (such as clean installations of Windows 8 and Windows 10), you should set your applications to use ".NET framework 4" (or higher) as target framework and you should replace the original reference to AudioDjStudio with the newest AudioDjStudioF4. The tutorial How to port existing projects for compilation for .NET framework 4 explains how to perform the porting of your application's project.