It seems like the browser you are using has JavaScript disabled. As a result, the site will not function properly. We really want you to enable it so you may experience our site as we intended it. If you have no idea what we are talking about or if you need help, visit http://www.enable-javascript.com×
This website uses cookies. By continuing to browse this site you are agreeing to our use of cookies. Find out more on our cookie page.×

Oops, it seems like you're using an old browser that we do not fully support. If you're able to, please upgrade your browser here.×
This website uses cookies. By continuing to browse this site you are agreeing to our use of cookies. Find out more on our cookie page.×

Call

Since: BlackBerry 10.0.0

#include <bb/system/phone/Call>

To link against this class, add the following line to your .pro file: LIBS += -lbbsystem

Provides a call's ID, state, and type information.

When an outgoing call is initiated through a Phone object, an instance of this class will be returned to represent the initiated call. If the isValid() function of the object returns true, the client of this object can start to access other properties of the object.

An instance of the Call class will also be provided through the Phone::callUpdated() signal to provide information about an incoming call or update the state of an existing call.

Permissions:

You must also specify the access_phone permission in your bar-descriptor.xml file.

Returns the phone number of the remote end if the client has read_phonecall_details permission, returns an empty string otherwise.The phone number is considered to be sensitive data, it will be delivered to a client which has the permission. The remote number is the number on the other end of the call. In the case of an outgoing call, it is the number that is being called. In the case of an incoming call, it is the number that is doing the calling. If the call type is "multiparty", phoneNumber() will return an empty string. Note: The application that is asking for the phone number needs to be running in the same perimeter as the line that the call is on. As an example, an application running on the work perimeter will not have access to the phone number on a cellular call. Analogously, an application running on the personal perimeter will not have access to the phone number related to a call on a work line, e.g. a SecuVOICE call. Moreover, for an incoming call on the cellular line, the phone number will be delivered formatted. For an outgoing call, the phone number will be first delivered not formatted on the cellular line. After formatting has been applied to it, the subsequent call updates will have the formatted phone number.

Return:

The phone number of the remote end of the call. If the Call object is invalid, the return value is undefined.

Permissions:

The application must have the read_phonecall_details permission to use this feature.

Since:

BlackBerry 10.3.0

Last modified: 2015-01-22

Got questions about leaving a comment? Get answers from our Disqus FAQ.

1. Download the tools

Before you start developing, you'll need to visit the Downloads tab. Here you'll find downloads for the BlackBerry 10 Native SDK, BlackBerry 10 Device Simulator, and some other useful tools.

2. Try the sample apps

Now featuring a filter control, the Sample apps tab allows you to search for samples by name or by feature.

Select either the Core or Cascades radio buttons to display the samples relevant to you.

3. Educate yourself

The Documentation tab contains tons of examples, tutorials, and best practices to guide you along the path towards building an awesome app.

You can access all the documentation that you need in the left-hand navigation.

4. Start developing

The Reference tab is where you'll find essential details about how to use our APIs.

You can use the left-hand navigation to choose how you would like to browse the reference: by module, by topic, or alphabetically. If you have an idea of what you are looking for, start typing it in the Filter box.