Find file History
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
..
Failed to load latest commit information.
www
LICENSE
README.md
config.xml

README.md

BBM Channels Sample

This sample demonstrates how to invoke BBM Channels. You'll learn how to open, and post to BBM Channels.

Applies To

Author(s)

Dependencies

  1. bbUI.js is licensed under the Apache 2.0 license.

Icons

Contributing

Screenshots

image image

Required Plugins

The following Cordova Plugins are required for this sample:

com.blackberry.invoke

Invoking a Channel

The following code is used to invoke, and view a Channel

var request = {
    target: "sys.bbm.channels.card.previewer",
    action: "bb.action.OPENBBMCHANNEL",
    uri: "bbmc:C00124CF8"
};

blackberry.invoke.invoke(
    request,

    function() {
        console.log('success');
    },

    function(e) {
        console.log(e);
    }
);

Sharing Text

The following code is used to share text to a Channel

var request = {
    target: "sys.bbm.channels.sharehandler",
    type: "text/plain",
    action: "bb.action.SHARE",
    data: "this is a test"
};

blackberry.invoke.invoke(
    request,

    function() {
        console.log('success');
    },

    function(e) {
        console.log(e);
    }
);

Sharing Photos

The following code is used for sharing a photo with a Channel

var request = {
    target: "sys.bbm.channels.sharehandler",
    action: "bb.action.SHARE",
    uri: "local:///test.gif"
};

blackberry.invoke.invoke(
    request,

    function() {
        console.log('success');
    },

    function(e) {
        console.log(e);
    }
);

How to Build

  1. Clone this repo to your local machine.

  2. Ensure the BlackBerry 10 WebWorks SDK 2.0 is correctly installed.

  3. Open a command prompt (windows) or terminal (mac) and run the following command:

    webworks create <your source folder>\BBM-Channels
    
  4. Replace the default BBM-Channels\www folder with the \www folder from this project

  5. Replace the default BBM-Channels\config.xml with the config.xml from this project

  6. From the command prompt (Windows) or terminal (mac), navigate to the BBM-Channels folder

    cd <your source folder>\BBM-Channels
    
  7. Run the following commands to configure plugins used by this app

    webworks plugin add com.blackberry.invoke
    
  8. Run the following command to build and deploy the app to a device connected via USB

    webworks run
    

More Info

Contributing Changes

Please see the README of the BB10-WebWorks-Samples repository for instructions on how to add new Samples or make modifications to existing Samples.

Bug Reporting and Feature Requests

If you find a bug in a Sample, or have an enhancement request, simply file an Issue for the Sample.

Disclaimer

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.