Simple BBM Integration in WebWorks Featured

Jeremy wrote up a great article about integrating BBM into Cascades, and a few people mentioned they wanted to see an article about getting BBM integrated with WebWorks. I've been kind of off the radar lately, but figured this was a good topic for me to do a quick writeup on.

Now, to contnue with some friendly teasing I directed at Jeremy eariler: integrating BBM into Cascades may be easy, but integrating it into WebWorks makes integrating it into Cascades look like rocket science. Yes, it really is that easy.

If you want to follow along, about 8 months ago I wrote up a BBM Integration Sample that I'll be using in this article. You can find it at https://github.com/SCrid2000/SCrApps-WebWorks-BB10-Apps/tree/master/KISSBBM.

1First, make sure you get your config set up right. For BBM integration, you need two additions:

<feature id="blackberry.bbm.platform" />
<rim:permissions>
     <rim:permit>bbm_connect</rim:permit>
</rim:permissions>

2Now that your config.xml is set up, you need to add some JavaScript to register your app with the BBM Server. To do that, you use the following function:

document.addEventListener('DOMContentLoaded', function() {
	blackberry.event.addEventListener('onaccesschanged', function (accessible, status) {
		if (status === 'unregistered') {
			blackberry.bbm.platform.register({
				uuid: '33490f91-ad95-4ba9-82c4-33f6ad69fbbc'
			});
		} else if (status === 'allowed') {
			bbm.registered = accessible;
		}
	}, false)
})

I personally use http://www.uuidgenerator.net/ to get a UUID, but you can get one wherever you want. MAKE SURE YOU ALWAYS GET A NEW UUID! Do not use the one used in this function.

Just put that code in any JavaScript document that's loaded in your app, and your users will be connected!

3Now that you're registered, add whatever BBM Integrated function you want to an event, such as a button click. Some examples:
Allow users to update their BBM Status:

blackberry.bbm.platform.self.setPersonalMessage('I love OSBB!')

Allow people to change Availability Status:

blackberry.bbm.platform.self.setStatus('available', 'I\'m available!')

To invite other people to download your app:

blackberry.bbm.platform.users.inviteToDownload()

It really is that simple. So get out there, and integrate your apps with BBM!

 

Shane Cridlebaugh

Co-founder and legal nay-sayer of OSBB. Owner of SCrApps Application Development, WebWorks aficionado, Open Source contributor. SCrid2000 on most blogs. I build awesome BlackBerry apps when I'm not doing legal work or spending time with my wife and two boys.


Follow me on Twitter - @GShaneC

Check out my apps in BlackBerry World

Website: SCrApps.org
More in this category: « The Power of Ant Build

Leave your comments

Post comment as a guest

0

People in this conversation

  • Guest (jhonny)

    Great article about BBM integrated with WebWorks. You have picked up a great topic. I have learned a lot from your article which will help me in learning it better.
    Get painting and decorating services here

    Like 0 Short URL:
  • Guest (sheral)

    I always research for articles that can help me. There is obviously a lot to know about this. I think you will make some good points in Features .Keep working, great job! sticker design and printing

    Like 0 Short URL:
  • Guest (jessica alex)

    wonderful article about Simple BBM Integration in WebWorks, you have made a great effort in making this post which i appreciate it a lot. I must say you have assignment help uk for these articles after lot of research.

    Like 0 Short URL:
  • Guest (tema)

    It is one of the best information which you are providing. I love your blog because it totally full of informative posts. You are nice one and thanks for sharing.
    Jersey framing services

    Like 0 Short URL:
  • Such an informative article about the BBM integration in web works. The process of registration is laso give. Registered yourself without wasting your time. A great chance for you people. I registered myself after reading this article. Thank you for this information.

    Like 0 Short URL:
  • Guest (aftab ali)

    Blood suckers are not just found in unsanitary conditions, as a great many people trust; they can likewise attack a perfect home through an assortment of outlets. punaise de lit traitement

    Like 0 Short URL:
  • Guest (suman)

    New web site is looking good. free gift card generator Thanks for the great effort.

    Like 0 Short URL:
  • Guest (Carmon J. Munoz)

    In the event you Chances need information about supply string receive your-self a grip subsequently predicts Jonathon Karelse that they truly are likely to inspire you to create you the particular advice.

    Like 0 Short URL:
  • I am online game player of free robux because it is really very amazing game and I really like this version most.

    Like 0 Short URL:
  • Guest (jason)

    United States

    there are webpage where you play online stickman games completely free of cost.

    Like 0 Short URL:
Subscribe to the official OSBB BBM Channel!

osbbchannelQR

C00013E89

Back to top