How To Get Your Voyager Pro UC to Tweet

Bootstrapping Your Development Environment:

Here are some things I assume you are developing with:

• Microsoft Visual Studio 2015
• C#

Here is the shopping list you will need:

• The Plantronics SDK
• NuGet for Microsoft Visual Studio:http://www.nuget.org/
• The TweetSharp libraries - can be installed via NuGet: https://github.com/danielcrenna/tweetsharp

 

Launch Microsoft Visual Studio

Create a .NET 4.6 C# Console Application project - In this example I created a project called TweetMe

After the project has been created rename the default Program.cs to TweetMe.cs

 

Adding The Plantronics and TweetSharp Dependencies

 

Getting TweetSharp

NuGet can be found under the Project menu in Visual Studio. To add TweetSharp to your project, click on the Project menu and select the "NuGet Package Manager" option and go to "Manage NuGet Packages for Sol.  Once the NuGet dialog box shows up search for the TweetSharp libraries and add them to your project by installing it.

Add the Plantronics SDK References

You will need to add the Interop.Plantronics reference to the solution.



Once you have the TweetSharp and Plantronics assemblies referenced, your project's reference list should look like this:

 

Step 1: Initialize Twitter.

The IPlugin interface has three methods that must be implemented Name, Init and Exit, below is a skeleton of what an empty plug-in implementation looks like.

using System;
using System.Runtime.InteropServices;
using TweetSharp;
using Interop.Plantronics;
 
namespace TweetMe
{
    public class TweetMe
    {
        //Twitter integration stuff
        //NOTE: you must get your own keys/tokens in order to make this tweet to your _twitter account!
        //To do this simply register at the following site: https://dev.twitter.com/apps/new
        static String twitterConsumerKey = "yourConsumerKey";
        static String twitterConsumerSecret = "yourConsumerSecret";
        static String twitterAccessToken = "yourAccessToken";
        static String twitterAccessTokenSecret = "yourAccessTokenSecret";
        static String twitterUserHandle = "yourUserHandle";
 
        static TwitterService _twitter;
        
        InitializeTwitter();
    }
 
    //_twitter initialization
    private static void InitializeTwitter()
    {
        //initialize _twitter
        _twitter = new TwitterService(twitterConsumerKey, twitterConsumerSecret);
        _twitter.AuthenticateWith(twitterAccessToken, twitterAccessTokenSecret);
    }
}

Step 2. Add Plantronics Objects

Start to adding the Plantronics objects we will be using to gain access to the headset events.

....
 
namespace TweetMe
{
    public class TweetMe
    {
        private static COMDevice _device;
        static ICOMDeviceListenerEvents_Event _devListener;
        private static ICOMHostCommandExt _command;
 
        //Twitter integration stuff
        //NOTE: you must get your own keys/tokens in order to make this tweet to your _twitter account!
        //To do this simply register at the following site: https://dev.twitter.com/apps/new
        static String twitterConsumerKey = "yourConsumerKey";
        static String twitterConsumerSecret = "yourConsumerSecret";
        static String twitterAccessToken = "yourAccessToken";
        static String twitterAccessTokenSecret = "yourAccessTokenSecret";
        static String twitterUserHandle = "yourUserHandle";
 
        static TwitterService _twitter;
        
        //Get a valid _device
        COMSessionManager mgr = new COMSessionManager();
        COMSession sess;
        mgr.Register("My Session", out sess);
        _device = sess.GetActiveDevice();
 
        //Cast HostCommand and init _command.
        _command = _device.HostCommand as ICOMHostCommandExt;
 
        //Cast HostCommand and DeviceListener and init _command and _devListener.
        _command = _device.HostCommand as ICOMHostCommandExt;
        _devListener = _device.DeviceListener;
 
        _devListener.onHeadsetStateChanged += devListener_HeadsetStateChanged;
 
        InitializeTwitter();
    }
 
    private static void devListener_HeadsetStateChanged(COMDeviceListenerEventArgs args)
    {
        
    }
...

Step 3: Request Proximity

To receive proximity data, you will need to call _command.RequestProximity() after you start listening for headset events.

....
 
namespace TweetMe
{
    public class TweetMe
    {
        private static COMDevice _device;
        static ICOMDeviceListenerEvents_Event _devListener;
        private static ICOMHostCommandExt _command;
 
        //Twitter integration stuff
        //NOTE: you must get your own keys/tokens in order to make this tweet to your _twitter account!
        //To do this simply register at the following site: https://dev.twitter.com/apps/new
        static String twitterConsumerKey = "yourConsumerKey";
        static String twitterConsumerSecret = "yourConsumerSecret";
        static String twitterAccessToken = "yourAccessToken";
        static String twitterAccessTokenSecret = "yourAccessTokenSecret";
        static String twitterUserHandle = "yourUserHandle";
 
        static TwitterService _twitter;
        
        //Get a valid _device
        COMSessionManager mgr = new COMSessionManager();
        COMSession sess;
        mgr.Register("My Session", out sess);
        _device = sess.GetActiveDevice();
 
        //Cast HostCommand and init _command.
        _command = _device.HostCommand as ICOMHostCommandExt;
 
        //Cast HostCommand and DeviceListener and init _command and _devListener.
        _command = _device.HostCommand as ICOMHostCommandExt;
        _devListener = _device.DeviceListener;
 
        _devListener.onHeadsetStateChanged += devListener_HeadsetStateChanged;
 
        InitializeTwitter();
 
        RequestProximity();
    }
  
    private static void RequestProximity()
    {
        try
        {
           if (_command != null)
               _command.RequestProximity();
        }
        catch (COMException ex)
        {
           Console.WriteLine(ex.Message + "\r\nPlease use a _device that supports proximity.");
        }
    }
}

Step 4: Tweet!

Now add the code to tweet your headset events!

• HeadsetState.Don - Capacitive sensor event that the user is wearing their headset
• HeadsetState.Doff - Capacitive sensor event the user has take off their headset
• Proximity.Near - event that the headset is near the host system
• Proximity.Far - event that the headset is far from the host system (but still in range)

  private static void devListener_HeadsetStateChanged(COMDeviceListenerEventArgs args)
  {
        switch (args.HeadsetStateChange)
        {
             case (DeviceHeadsetStateChange.HeadsetStateChange_Don):
                SendTweet("At " + DateTime.Now.ToString("H:mm:ss") + " my Plantronics headset sensors told me that " + twitterUserHandle + " is wearing me!");
                break;
             case (DeviceHeadsetStateChange.HeadsetStateChange_Doff):
                SendTweet("At " + DateTime.Now.ToString("H:mm:ss") + " my Plantronics headset sensors told me that " + twitterUserHandle + " has taken me off.");
                break;
             case (DeviceHeadsetStateChange.HeadsetStateChange_Far):
                SendTweet("At " + DateTime.Now.ToString("H:mm:ss") + " my Plantronics headset sensors told me that " + twitterUserHandle + " is away from their desk.");
                break;
             case (DeviceHeadsetStateChange.HeadsetStateChange_Near):
                SendTweet("At " + DateTime.Now.ToString("H:mm:ss") + " my Plantronics headset sensors told me that " + twitterUserHandle + " is at their desk.");
                break;
             default:
                SendTweet("At " + DateTime.Now.ToString("H:mm:ss") + " the following Plantronics headset event " + args.HeadsetStateChange + " occured for " + twitterUserHandle);
                break;
        }
  }
 
  //_twitter send tweet and display status
  private static void SendTweet(string text)
  {
       SendTweetOptions options = new SendTweetOptions {Status = text};
       TwitterStatus status = _twitter.SendTweet(options);
       if (status == null)
       {
           Console.WriteLine("Tweet failed, no status returned. (have you added key/token/user etc at top of code?)");
       }
       else
       {
           Console.WriteLine("Created a new tweet, id = " + status.Id);
       }
   }

The Source Code:

Well there you go... I hope this works for you, if you encounter any problems let me know!
Download link: TweetMe.zip

Cheers,
-Cary