It started out innocently enough – a phone call on my mobile phone while I was at work. Looking down I didn’t recognize the number…it was an 866 number. I hesitated and then answered it…ugh-how the heck is some telemarketer calling me on my mobile phone? I hung up but then later another 866 number called. I promptly hit the “ignore” soft-key and away my troubles went. Fast forward about 40 minutes and the same number calls me again. Ignore again and this time I saved it in my contacts list as “Annoying 866 caller” which had reminded me of a similar story I’ll tell you all about a woman in Ohio who kept dialing my number by mistake for months, but for now let’s get back to the problem at hand.
I started thinking about it and then it really bothered me…this is my cell phone after all so why can’t I control whether I want to be bothered by such calls? Well with Windows Mobile I can! This blog entry is going to cover the basics of call management with Windows Mobile using the State and Notifications Broker and Platform-Invoke.
Let’s lay a few ground rules first – to the best of my knowledge there does not exist a way to automatically (read that programmatically) reject an incoming call without any kind of notification to the user. I can live with that and work around that. My end goal in designing this project was to eliminate the need for me to deal with pesky toll-free numbers calling me on my cell phone…it was only after I completed this first iteration of the project that other ideas crept into my head and realized there’s a lot more that can be done to make my phone truly work for me…more on that later.
So since we can’t automatically reject the call, what’s left to do? Well looking at my normal actions I can break it down like this:
- Phone Rings – look at the incoming number displayed on my screen
- Is the number an 800 number? If so, press the “Ignore” soft-key and then acknowledge the “missed call” notification.
Since that’s a short series of manual steps, we can automate that and my life becomes easier again :)
Making friends with the State and Notifications Broker
If you’re developing software with Windows Mobile you don’t go very far before realizing you need to get acquainted with the State and Notifications Broker (SNB). The SNB gives you an incredible mechanism for storing and working with information related to state changes associated with your mobile device. I won’t re-hash what’s already been written about SNB – instead you can read about it on MSDN to get started. Here's the link: http://msdn2.microsoft.com/en-us/library/aa455748.aspx
The SNB plays a key role in our project because it is going to detect the presence of an incoming call and then retrieve the number of that incoming call. Once we have the number we’re just going to analyze it and then let it go through so I can answer it or programmatically press the “Ignore” soft-key and I won’t have to deal with it. So let’s take a look at the code we’re going to use for this.
I’ve set up a small sub called MonitorNotifications which is called when the form loads. This sub adds my phoneStatus System State Notification to an array list I’ve created (in case I later want to add more system state notifications to this project)
You’ll notice the SystemProperty I’m monitoring in this case is PhoneIncommingCall and I’ve added a handler for when that status changes.
So what happens then in the event handler for ChangeOccured? Take a look below:
Basically this just handles the logic for the phone call management. First we’re checking to see if I feel like ignoring all calls (via a check box on my form) and then we’re checking to see if the incoming call number is in my simple “block number” (a text box on the screen). If either of those conditions are true, then bounce the call with the BounceCall sub.
The BounceCall sub makes use of P-Invoke to programmatically press the “Ignore” soft-key that shows up on screen when an incoming call is present on your device. A full write-up on P-Invoke is beyond the scope of this article so take this as a starting point and learn from it…I’ll cover more about P-Invoke in later articles. Here’s the code we’re working with:
First we’ve defined two constants for use with our keyboard events. Then we use P-Invoke to handle the actual keyboard event. BounceCall simply does a programmatic “Key Down” and then “Key Up” on the appropriate soft-key.
Now that we’ve gone over the basics of the code involved let’s see the app in action.
Here we have the basic form up and running in our emulator. Notice my neat little bouncer guy – I thought it an appropriate graphic for the project!
Next fire up the Cellular Emulator tool (If you’re not sure how to configure this to work with the emulator, take a look at my previous article which details these steps) http://ilovevb.net/Web/blogs/vbmobile/archive/2008/01/07/vb-net-mobile-hello-world.aspx
Once you’ve got the Cellular Emulator running, place a call to the device emulator to see it show up on the screen as shown below.
Notice the “Accept” and “Ignore” soft-keys present when an incoming call is in progress. Go ahead and Ignore the test call for now and then take that same number you just called with and put it in the text box on the form as shown below:
When you place the call this second time you may not actually notice anything in the emulator – but go ahead and click on the “Missed Call” notification icon in the top bar of your screen..you should see now two missed calls – the first one you manually did to test and the second one programmatically handled by our call bouncer as shown below:
And the cool thing is with it working that fast in the emulator, imagine how fast it can act on your device! Unless I have my phone set to vibrate and it’s on some kind of hard surface, I don’t even realize that my call bouncer just rejected a call….it happens so quickly. What typically happens is that later in the day I notice a missed call icon and click to view it…sure enough there’s an 800 number there.
A few final notes about this project…
So what really happens when you programmatically press the ignore button on the phone? In my case, it drops the caller to voice mail – but the trick here is I purposefully do not have a voice mailbox set up on my account (I have one available, I just never set it up) so they just get a message saying that the current subscriber does not have voice mail configured – goodbye. In your case maybe you do have voice mail set up in which case you’ll likely get a voice mail notification later on.
Also – in this project I mention dropping “800” numbers which my phone does now. This example however limits it to just a single number in a text box to compare with versus using some kind of matching (hint: regular BLOCKED EXPRESSION for 800 numbers. I’m leaving that implementation up to the reader to figure out, grow and learn with based on the foundational knowledge I’ve provided here. Once you’ve hooked into the SNB and are handling a call, what you do with it is up to you.
Full source code for this example will be posted later…until then, give it a try setting this up on your own and let me know what you think about this article as well as what other future articles you’d like to see.
Oh - and about that lady from Ohio that called my phone repeatedly over the course of a few months. The first time she called I answered because I actually do have friends from Ohio who maintain their cell phone numbers there. When she asked for someone who I clearly do not know, I told her she had the wrong number and she called back a few minutes later. Same story - same wrong number. Annoyed I saved the number to my contacts list as "Ohio Wrong Number". A few days later I recognized the number calling me again and this time answered it "Ohio Telecom Wrong Number Department, How may I direct your call?" The rest of the conversation follows:
Her: "I'm trying to get in touch with Sara at (555) 555-1212 (number masked to protect the innocent)"
Me: "Sorry - you dialed (111) 111-1111 by mistake (my number masked so I don't have to add a bunch of you to my blocked call app!). To get in touch with Sara you'll need to hang up and dial (555) 555-1212
Her: "OK thanks!"
And then I wondered how long before she'd catch on to the flaw in that whole transaction. In any case - she never did catch on. Over the next few months she occasionally continued to call and I would continue to answer as the "Wrong Number Department". Occasionally I would be with friends when she would call and I'd have them answer as the "Wrong Number Department" too. Sometime late last year she finally stopped calling me. Now I just have her in my call block list for this app on my phone!