TeamTalk 4 .NET DLL  Version 4.5A
Client Setup Guide

When distributing an application which uses the TeamTalk 4 SDK the following files must in the working directory of the application:

  • TeamTalk 4 SDK Standard Edition
  • TeamTalk 4 SDK Professional Edition

Build managed TeamTalk 4 DLL wrapper

The TeamTalk 4 .NET Client DLL is built using the Visual Studio project located in the "Client/NET/TeamTalk4.NET" folder of the SDK.

The TeamTalk 4 .NET DLL simply wraps the C-API DLL TeamTalk4.dll (or TeamTalk4Pro.dll in the Professional SDK) so .NET developers don't have to deal with messy native code calls.

Since the .NET DLL is a wrapper for the C-API DLL the TeamTalk 4 C-API DLL must also be included with the .NET DLL.

Visual Studio Setup

This section shows how to set up Visual Studio (VS) to use the TeamTalk 4 .NET client DLL in a VS-project. The .NET DLL contains native code and it is therefore important to configure the VS-project to be aware of this. The following image shows what needs to be configured in VS:

vssetup.png
Visual Studio Project Setup

If the PC used for developing the user application is running Windows x64 and the developer wants to use the x86 .NET DLL the project must be configured to run as an x86 application. Item 1 in the picture above shows where to to this. Simply open the "Configuration Manager", add the x86 configuration and set it as the active Platform.

Next the TeamTalk4.NET.dll must be added as a reference to the project. Item 2 shows where to do this. When the "Add Reference" dialog opens click the "Browse"-tab and find the TeamTalk4.NET.dll file. The list of references will now contain TeamTalk4.NET as is seen in item 3.

Last we need to set the working directory so the TeamTalk native DLLs can be loaded. This is done by clicking Properties for the project and setting the "Working directory" in the Debug-tab as shown below:

vsworkdir.png
Setting the working directory

To check that everything is now in working order try adding the following code to the Windows Form application's contructor and run the application:

namespace WindowsApplication1
{
public partial class Form1 : Form
{
BearWare.TeamTalk4 ttclient;
public Form1()
{
InitializeComponent();
//we pass 'false' since we're a Forms application
ttclient = new BearWare.TeamTalk4(false);
}
}
}

Hopefully the application now starts without any errors. If an exception occurs about missing dependencies then ensure that the application is able to load the TeamTalk client's DLL file, i.e. ensure the working directory is correct.

If the above application starts then move on to section Client Programming Guide to see how to use with the TeamTalk client DLL.