The BBM Carousel example allows the developer to invoke BlackBerry Messenger(BBM) using the Invocation Framework. For devices running 10.1 that are also BlackBerry Balance enabled, the work perimeter only allows for a limited set of BBM features to be invokable. This sample implements those features:
- Invite a user to chat
- Share text to an individual contact
- Share text to a group
- Share an image to an individual contact
- Share an image to a group
The implementation for the invocation of the aforementioned features are in the Carousel.cpp file.
The sample was built using the "bbjamcarousel" example located here
The sample code for this application is Open Source under the Apache 2.0 License
- Johan Larsby the author of that "bbjamcarousel" sample
- Rich Balsewich for modifying the "bbjamcarousel" sample and providing the implementation framework to tie in the BBM invocation code to
- BlackBerry 10 Cascades SDK
- This sample has been tested using the 10.1.0.1020 SDK
- BlackBerry 10 Native SDK
- BlackBerry 10 smartphone to test
- If you intend to test in Corporate Perimeter, you will need a BlackBerry Device Service Server or access to one. (optional)
Running the example:
- Clone the Sample repository.
- Launch BlackBerry 10 Native SDK, and from the File menu, select Import.
- Expand General, and select Existing Projects into Workspace. Click Next.
- Browse to the location of your sample directory, and then click OK.
- The sample project should display in the Projects section. Click Finish to import the project into your workspace.
- In the Project Explorer pane, Right-click the project (for example BBM Carousel) and select Build Project.
- In the Project Explorer pane, Right-click the project (for example BBM Carousel) and select Run As > BlackBerry C/C++ Application.
- The application will now install and launch on your device. If not, check that your environment is set up correctly here
Running the example in corporate perimeter
Steps apply to BlackBerry Balance Enabled devices
- Build, sign, and export the project (Create the .bar file)
- Add it to the BlackBerry Device Server.
- Add it to a software configuration.
- Apply the software configuration to the user account you are testing with. BlackBerry Device Service Documentation
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.