bria android edition user guide - counterpath · counterpath corporation about bria android edition...

Bria Android Edition User Guide

CounterPath CorporationSuite 300, One Bentall Centre 505 Burrard Street, Box 95Vancouver, BC V7X 1M3Canada

Telephone + [email protected] © 2017 CounterPath Corporation. All rights reserved.

This document contains information proprietary to CounterPath Corporation, and shall not be used for engineering, design, procurement, or manufacture, in whole or in part, without the consent of CounterPath Corporation. The content of this publication is intended to demonstrate typical uses and capabilities of the CounterPath Bria Android Edition application. Users of this material must determine for themselves whether the information contained herein applies to a particular IP-based networking system. CounterPath makes no warranty regarding the content of this document, including—but not limited to—implied warranties of fitness for any particular purpose. In no case shall CounterPath, its employees, officers or directors be liable for any incidental, indirect or otherwise consequential damage or loss that may result after the use of this publication.

CounterPath, the logo, and Bria are registered trademarks of CounterPath Corporation.All other products and services are the registered trademarks of their respective holders.

This guide corresponds to Bria Android Edition version 3.9Rev 4May 2017

ContentsAbout Bria Android Edition 1

Standard Telephone Features.....................................................................................................1Advanced Features.....................................................................................................................1Operating System Requirements ...............................................................................................2Supported Accessories ...............................................................................................................2Using Bria’s Interface ................................................................................................................2Interaction between Bria and Native Phone ..............................................................................4Widget........................................................................................................................................4

Configuring 6Launch and Close.......................................................................................................................6Initial Setup................................................................................................................................6Set Up Bria for Voice and Video Calls......................................................................................7Set Up Bria for Presence and Messaging...................................................................................9Account Status .........................................................................................................................11Configure Dial Plans (Number Prefixes).................................................................................11

Voice and Video Calls 14Place a Voice or Video Call.....................................................................................................14Handle Incoming Calls ............................................................................................................19

Advanced Calling Options 26Navigate Away From a Call ....................................................................................................26Return to an Active Call ..........................................................................................................27Place a Second Call..................................................................................................................28Swap Between Calls ................................................................................................................33Conference Calls......................................................................................................................34Transfer a Call .........................................................................................................................35Call Recording .........................................................................................................................40Change the Audio Output ........................................................................................................43Voice Mail ...............................................................................................................................44Change SIP Accounts ..............................................................................................................45Pause Dialing for Auto Attendant............................................................................................48

Call History 50View Call Information .............................................................................................................50Delete Call Log Entries............................................................................................................51Create a New Contact ..............................................................................................................52Add to an Existing Contact ......................................................................................................53

Contacts 55Add a Contact ..........................................................................................................................55Edit a Contact...........................................................................................................................55Delete a Contact.......................................................................................................................57Favorites...................................................................................................................................58Contact Fields ..........................................................................................................................64

i

CounterPath Corporation

Presence and Messaging 65Presence ...................................................................................................................................65Buddies ....................................................................................................................................68Add a Buddy ............................................................................................................................68Delete a Buddy - SIP and XMPP.............................................................................................72Buddy Requests .......................................................................................................................74Send an IM...............................................................................................................................75View and Reply to an IM.........................................................................................................79Send an SMS............................................................................................................................82XMPP Group Chat...................................................................................................................84Delete, Copy, or Forward Messages ........................................................................................88

Settings 91Accounts ..................................................................................................................................91Preferences.............................................................................................................................101Advanced Settings .................................................................................................................105 Premium Features .................................................................................................................110Share ......................................................................................................................................112

Troubleshooting ...........................................................................................................................113Using Bria Diagnostics ..........................................................................................................113More Information and Technical Support .............................................................................114

Glossary .......................................................................................................................................115

Bria Android Edition User Guide version 3.9 ii

CounterPath Corporation About Bria Android Edition

1 About Bria Android Edition

Bria Android Edition is a SIP-based phone for Androids. With Bria, you can use a Wi-Fi Internet connection on an Android to make and receive calls without using mobile data plan. You can also use a mobile connection for phone calls when you are not in a Wi-Fi zone if your device supports a mobile connection.

Bria does not come with a SIP or XMPP service. You must have a subscription to a SIP/VoIP service provider in order to make calls. Your SIP service provider must support SIP SIMPLE or you must have an XMPP account to use presence and messaging.

1.1 Standard Telephone Features• Call display and voice mail indicator.• Speakerphone, mute, and hold.• Call history: List of received, missed, and dialed calls.• Call transfer.• Audio call record.• Three-way audio conference.• Audio codecs: G.711ΑLaw, G.711μLaw, G.722, GSM, Opus, SILK™, Speex-NB, and Speex-WB.

G.729 and AMR-WB audio codecs must be purchased separately as an in-app purchase.• Ringtones and contact avatars.• DTMF support: Enter the numbers to use with an auto attendant.

1.2 Advanced Features• Video calls: Must be purchased separately as an in-app purchase.• Video codecs: H.264 and VP8• Presence and Messaging using the XMPP protocol and the SIP SIMPLE protocol.

Must be purchased separately as an in-app purchase.• NAT traversal: STUN, TURN, ICE, and rport.• Secure call signaling: TLS.• Audio encryption: SRTP.• Quality of Service: QoS.• DNS SRV record lookups.• Call quality statistics.• Application diagnostics: Logging and log files uploading.

Bria Android Edition User Guide version 3.9 1


1.3 Operating System RequirementsBria runs on Android 4.4 (KitKat) and higher.

1.4 Supported AccessoriesBria supports the following accessories:

• Headset with microphone (including Bluetooth™): Bria uses the earpiece and microphone on the headset.• Headphones (no microphone): Bria uses the earpiece on the headphones and the built-in microphone on the

Android.

1.5 Using Bria’s InterfaceTap the Settings icon and tap Help or tap the Bria icon on the Phone tab to access the online help.

Tap the Bria logo to access online help

Tap Help in Settings



Use the navigation tabs on Bria’s resource panel or swipe between panes to navigate in Bria.

Bria also uses the Android buttons for navigation. They are Back, Home, and Overview.

Account status and primary SIP account.

Dial Pad

Resource Panel

Navigation Tabs

Tap to select dial-out account (appears only if more than one SIP account is enabled).

More icon

Action Bar

New message and missed call icons in the status bar

Notifications when notification center is opened

Log in status is displayed for your Bria accounts

Android Notification Center

HomeBack Overview HomeBack Overview



1.6 Interaction between Bria and Native Phone

Contacts• Bria uses the contacts saved on your phone. Bria’s contacts are continually synchronized with your native

contacts; adding, modifying or deleting a contact from one list updates the other list.

Making Calls• You can make a Bria call as long as you are not already on a native call or not already on two Bria calls.• You can make a native call, regardless of the state of Bria.

Incoming Calls • An incoming Bria call rings on your phone unless you are on a native call or you are already on two Bria

calls. In both these cases, the new incoming call will go to Bria voice mail (if it is configured).• Incoming native calls: Being on a Bria call has no impact on your native phone: native calls will be

received in the usual way. Therefore, you should be prepared to accept or decline a native call.

Established Calls • If you accept an incoming native call, any live Bria call is put on hold. You will not be able to take the Bria

call off hold until you end the native call.• You can have two Bria calls established at the same time and switch between them.

1.7 WidgetYou can add the Bria widget to your home screen. The Bria widget allows you quick access to each tab of Bria. The widget does not show a badge for unread messages or missed calls.



To add the widget to the home screen, go to the widgets library on your device, look for Bria, hold down the Bria icon, and drop it on to your Home screen.

Hold down the icon Bria widget on home screen


CounterPath Corporation Configuring

2 Configuring

2.1 Launch and Close

Launch BriaTo launch Bria, tap the Bria icon. The Bria screen appears after a few seconds.

Close BriaTo exit Bria, tap the More icon in the action bar and tap Exit.

2.2 Initial SetupNOTE: We strongly recommend that your perform your initial setup from within a known network, such as in your enterprise or university campus Wi-Fi zone or within range of your home network and not in a network such as an Internet Cafe.

1. Set up a Wi-Fi connection. Go to Android Settings > Wi-Fi and make sure the Wi-Fi is turned ON. If Wi-Fi is turned OFF, turn Wi-Fi ON, and select the network you want to connect to. If required, enter the password for the network.

2. Set up mobile data (optional). Go to Android Settings > SIM & network settings and:• Turn ON Mobile Data.• Make sure Preferred network type is not set to 2G only.

3. Obtain the following information from your VoIP service provider:• Username• Password• Domain• Authorization name, if used by your service provider• Voice mail number, if your service provider provides this service

4. Obtain the following information from your XMPP provider (optional):• Username• Password• Domain



5. Tap the Bria icon on the Android device device.

6. Read and accept the License Agreement.

7. If there is no Wi-Fi network available, you need to let Bria use mobile data. Go to Settings > Preferences and turn ON Use When Available and Allow VoIP calls.

8. When prompted, give Bria the following permissions:• Allow Bria to make and manage phone calls: Allows Bria to read phone status and identity, reroute

outgoing calls and directly call phone numbers.• Ignore Battery Optimizations: Allows Bria to stay connected in the background.• Permit drawing over other apps: Allows Bria to use Call Heads.• Allow Bria to access your contacts: Allows Bria to share contacts with device’s native contacts.• Allow Bria to record audio: Allows Bria to use your microphone.Permissions for Bria can be managed by going to your device’s Settings > Apps > Bria on devices running Android 6.0 (Marshmallow) or newer.

NOTE: To use the microphone for audio on calls, you need to Allows Bria to record audio.

2.3 Set Up Bria for Voice and Video CallsTo use Bria for voice and video calls, you need to set up a SIP account. You need your username, password, and domain from your VoIP service provider. If you have voice mail with your service provider, your VoIP service provider uses an authorization name, or your VoIP service provider uses an outbound proxy, you need to get your voice mail number, the authorization name, and the outbound proxy from your VoIP service provider as well.

Set Up a SIP Account1. Go to Settings > Accounts and tap +.

2. Select your VoIP service provider from the list of VoIP service providers. If your VoIP service provider is not listed, tap (SIP) Making Calls from the User-defined Generic Accounts section.



3. Complete Account Name, Display as, Username, Password, Domain, and VM Number (if you have voice mail) with the information provided by your VoIP service provider.

4. If you have an authorization name, tap Account Advanced and complete the Authorization Name field and tap to return to the Account Details screen.

5. Tap to return to the Accounts screen.

Your SIP account is set up. Bria displays the SIP account in Settings > Accounts.

Set Up Multiple SIP AccountsYou can have more than one SIP account if you have more than one VoIP service provider. To add another account, follow the Set Up a SIP Account steps.

Set Your Primary SIP AccountOne SIP account is always set as your primary account. Bria uses your primary account to make voice and video calls unless you choose a different SIP account when you place a call.

1. Go to Settings > Accounts.

2. Long press the account you want to set as your primary account.

3. Tap Set as primary.

Your primary account has a green dot beside it in Settings > Accounts.

Delete a SIP Account1. Go to Settings > Accounts.

2. Long press the account you want to delete.

3. Tap Delete.

Bria deletes the account and no longer displays it in Settings > Accounts.



2.4 Set Up Bria for Presence and MessagingNOTE: Make sure yourVoIP service provider supports SIP SIMPLE before purchasing the Presence and Messaging premium feature if you plan to use your SIP account for Presence and Messaging.

Presence and Messaging is a premium feature that is available as an in-app purchase. See “Purchase a Premium Feature” on page 111. With Presence and Messaging, you can share your online status (presence) with your Buddies and exchange instant messages (IMs) with them.

Bria supports the XMPP and SIP SIMPLE presence and instant messaging protocols. To use a SIP account for Presence and Messaging, make sure your VoIP service provider supports this service for SIP SIMPLE. You can text (send SMS) to PSTN mobile phone numbers with your SIP account if your VoIP service provider supports this service.

To use the Presence and Messaging feature for SIP SIMPLE and/or XMPP, go to Settings > Premium Features and select Presence and Messaging. Follow the prompts to complete the purchase. After the purchase, the Messaging tab appears at the bottom of Bria. If the Messages does not appear, turn ON Settings > Preferences > Enable IM and Presence once you have set up your SIP or XMPP account.

Follow the steps below depending on the protocol you want to use.

Set Up a SIP AccountMake sure your VoIP service provider supports SIP SIMPLE for presence and messaging first.

If you have not created your SIP account, see “Set Up a SIP Account” on page 7.

1. Go to Settings > Preferences.

2. Turn ON Enable IM and Presence and Enable SMS (if applicable).

3. Tap .

4. Go to Settings > Accounts and toggle the account switch OFF.

5. Tap on the Account.

6. Tap Account Specific Features.

7. Select Enable IM and Presence and Enable SMS (if applicable).

8. Tap to return to Account Details.

9. Tap to return to Accounts.

10. Toggle the account switch ON.



The Messaging tab appears on the resource panel. The account is ready for Presence and Messaging. When a SIP SIMPLE account is used for Presence and Messaging, you must add Buddies manually. See “Add a Buddy” on page 68.

Set Up an XMPP AccountYou need your XMPP account Username, Password, and Domain to set up your XMPP account.

1. Go to Settings > Preferences.

2. Turn ON Enable IM and Presence.

3. Go to Settings > Accounts and tap +.

4. Tap (XMPP) Presence and IM from the User-defined Generic Accounts section.

5. Complete Account Name, Username, Password, and Domain with the information provided by your XMPP Provider.

6. Tap to return to Accounts.

The Messaging tab appears on the resource panel and Bria displays the XMPP account in Settings > Accounts. The account is ready for Presence and Messaging. As soon as your account is connected to an XMPP server, your Buddies appear on your Buddies list.

Delete a SIP or XMPP Account1. Go to Settings > Accounts.

2. Long press the account you want to delete.



3. Tap Delete.

The account is deleted and Bria no longer displays the XMPP account in Settings > Accounts. When you delete your XMPP account, your Buddies no longer appear in your contacts and your XMPP conversations are deleted.

2.5 Account Status

2.6 Configure Dial Plans (Number Prefixes)You can create a dial plan to modify a phone number used in a phone call (the input) to ensure the call is placed successfully. For example, you could create a dial plan to change any number that starts with “+1613” to “613”.

A dial plan belongs to a SIP account. You can create as many dial plans for an account as you need. If you want to use the same dial plan on more than one SIP account, you need to add it to each account. Bria goes through the dial plans in the order in which they appear on the screen.

Design a Dial PlanA dial plan has two parts:• A pattern that the phone number (the input) must match.• The modification to make if the input matches that pattern:

• Remove a prefix.

Status Account Type Means that...

SIP The account is in the process of registering.

SIP The account is registered and can be used to make and receive phone calls.

SIP The account is registered and can only be used to make phone calls.Accounts > Account Advanced > Incoming Calls is OFF.

SIP The account is disabled. Toggle the account switch to ON to register the account.

SIP The account in enabled but registration failed. Check that you entered your account credentials correctly.

XMPP The account is in the process of registering.

XMPP The account is registered and can be used for Presence and Messaging.

XMPP The account is disabled. Toggle the account switch to ON to register the account.

XMPP The account is enabled but registration failed. Check that you entered your account credentials correctly.



• Add a prefix.• Remove one prefix and add another one.

Set Up a Dial Plan1. Go to Settings > Accounts and tap the SIP account you are adding the dial plan to.

2. Tap Dial Plan (Numbered Prefixes).

3. Tap +.

4. Complete the following fields:• Name: The name of the rule.• Match Number: The pattern to be matched. Use the following characters to generate a match pattern:

• 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 0: A specific digit.• *, #, +, –: Other dial pad symbol.• [-]: A collection that can include a range. [6-9] matches any of 6, 7, 8, 9 and [012-6] matches any

of 0, 1, 3, 4, 5, 6.• x: A wildcard; matches any digit or symbol.• . (period): An element for repetition. Any element can be repeated 0 or more times. 12. matches 12,

122, 1222, 12222, etc.• Remove Prefix: The prefix to remove if the number matches the rule. You can use a dial plan to remove

a prefix string. If the number +16041122233 matches the pattern in Match Number and Remove Prefix is +1xxx, then the resulting number is 1122233.

• Add Prefix: The prefix to add to a number if the number matches the pattern in Match Number.• Number To Test: Enter a number that begins with the pattern in Match Number.

5. Tap Done.

6. Check the result in Resulting number to dial to see if the new number is correct.

7. Tap Save.

The dial plan is now in a list of dial plans for the SIP account. You can create as many dial plans as required.

NOTE: Rather than entering your phone number with x’s to complete the pattern, use a . (period). For example, instead of entering 604xxxxxxx, you can enter 604x.



Example 1Match number: +1613x. Remove Prefix: +1613 Add Prefix: 9

If the input starts with “+1613”, then remove the “+1613”, add “9”, and dial the number. So +16135550012 is dialed as 95550012.

Example 2Match number: [2-9]xxxxxxxxx Add Prefix: 1

If the input is a 10-digit number starting with a number other than 1, add “1” and dial the number. So 6045550012 is dialed as 16045550012.


CounterPath Corporation Voice and Video Calls

3 Voice and Video Calls

3.1 Place a Voice or Video CallTo use video calling on Bria, purchase the Video Calls premium feature (see page 111).

Settings > Accounts (SIP) > Account Specific Features > Enable Video and Settings > Preferences > Enable Video must be ON to place a video call.

If Settings > Accounts (SIP) > Account Specific Features > Always Offer Video is ON, the remote party will be offered video not matter which calling method you use.

Using the Dial PadWhen you place a call using the dial pad, Bria makes a voice call. To add video to the voice call, see page 18.

1. Go to the Phone tab on the resource panel.

2. Enter the number you want to call or enter the name you want to call. (Use 2 for A, B, C; use 3 for D, E, F; etc.) To clear the entry, tap the X. Bria brings up a list of matches and refines the list as you enter numbers and characters.

3. Tap after entering the number or tap on the contact you want to call.

Bria starts the voice call.



Using Bria’s ContactsIf phone numbers from Contacts need to be modified before you dial (for example, to remove extra characters such as +), you can set up a dial plan (see “Configure Dial Plans (Number Prefixes)” on page 11).

If Settings > Preferences > Single Touch to Call in ON and Settings > Accounts (SIP) > Account Specific Fea-tures > Enable SMS is OFF, you do not have to tap the Call Phone prompt to complete the voice call.

1. Go to the Contacts tab on the resource panel.

2. Tap the contact or tap the Search icon, enter a name, and tap the contact.

3. Tap the number you want to voice or video call.

4. Tap the Call Phone or Video prompt.

Bria starts the voice or video call. On a video call, Bria starts sending your video as soon as the remote party accepts your video call.

Using Call History - Call Details1. Go to the History tab on the resource panel.



2. Tap the history entry containing the contact you want to voice or video call.

3. Tap the number with the Phone icon or the Video icon beside it.


Using Call History - Phone IconIf Settings > Preferences > Single Touch to Call is ON and Setting > Accounts (SIP) > Account Specific Fea-tures > Enable Video and Settings > Preferences > Enable Video are OFF, you do not need to tap the Call prompt to complete the call.

1. Go to the History tab on the resource panel.



2. Tap the Phone icon beside of the history entry you want to call.

3. Tap the Call or Video prompt from Choose call type.


Using Call History - Long Press1. Go to the History tab on the resource panel.

2. Long press the history entry containing the contact you want to call.



3. Tap the Call or Video prompt.


Add Video to a Voice Call1. Swipe left of the screen.

OR

1. Tap More.

2. Tap Add video.

Bria starts initializing video. You see the remote party’s video after they add video on their end.



3.2 Handle Incoming Calls

Handling an Incoming Bria CallThe incoming call is displayed on Bria. When Bria is in the background and you receive a call, Bria is automat-ically brought to the foreground. You can answer a second incoming Bria call if you are already on a Bria call.

Drag the Incoming Call icon left to decline the call and right to accept the call.

Bria declines or starts the call.

If you accept a second incoming Bria call, Bria places the call in progress on hold. If you decline the call, the call in progress continues.

Bria’s advanced calling options are available when you accept a Bria call (see page 26).



If you need to access the dial pad during a call, tap the Dial Pad icon.

Call ReminderWhen you decline a call, Bria gives you the option to set a Call Reminder.

Turn ON Settings > Preferences > Decline Options > Enable Call Reminder if you want to be able to set a Call Reminder. Set the interval for the call reminder in Settings > Preferences > Decline Options > Call Reminder Delay.

Quick ResponseBria allows you to decline a call from an XMPP Buddy on the same XMPP server by sending a Quick Response to your Buddy.

1. Drag the Incoming Call icon up to decline a call with a Quick Response.

Call Reminder prompt

Call Reminder notification in Bria

Call Reminder is status bar

Call Reminder notification in Bria after opening the Android notification center.



2. Bria opens in the Messaging tab. Select the Quick Response you want to use or tap the + and create your own Quick Response.

3. Tap send.

Bria sends your Quick Response to your Buddy and ends the call.

Configure Quick Responses1. Go to the Settings tab on the resource panel.

2. Tap Preferences.

3. Tap Decline Options.

4. To remove a Quick Response from the list tap the X. To create your own custom response, tap +.

5. Tap the Back icon to return to the Preferences screen.

6. Tap the Back icon to return to the Accounts screen.

The Quick Responses have been deleted or added and can be used on an incoming call.



Handling an Incoming Native CallYou can receive a native call while you are on a Bria call. The incoming native call is displayed as a notification in front of the existing Bria call.

Tap one of the native incoming call options.

If you accept the call, the Bria call is placed on hold. You will not be able to take the Bria call off hold until you end the native call.

Handling an Incoming Video CallWhen the remote party places a video call, you see their video on Bria when you answer the call. You can send your video back, stop sending your video, or turn off the remote video.



Send Your VideoTap the Send icon or tap Tap To Send Your Video to send your video.

Bria starts initializing video.

Stop Sending Your VideoTap the Stop Video icon at the top of the screen.

Bria stops sending your video. You can still see the remote party’s video if they are sending it.

Remove All VideoSwipe right and tap More.

7. Tap Remove video.



Bria removes all video and switches to an audio call.

During a Video CallDuring a video call, you can: • Change to the rear facing camera.

• Transfer a video call. The transferred call is placed as an audio call, and then both parties can add video to the audio call. See “Transfer a Call” on page 35.

• Establish two video calls and merge them into an audio conference call. Video conference calls are not supported at this time. (See “Place a Second Call” on page 28 or see “Conference Calls” on page 34.)

• Record the audio portion of a video call. See “Call Recording” on page 40.• Mute a video call by tapping Mute or by swiping to the right and tapping Mute.

• Hide the Local Video Preview by tapping the Preview icon.

Swipe right and tap Mute.

Image Preview



Network QualityThe Network Quality Indicator on the call panel displays the current network conditions.

Wi-Fi NetworksIf the Network Quality Indicator shows “Poor”, this indicates there is network congestion or a poor quality Wi-Fi signal. Try moving closer to your Wi-Fi access point.

Mobile NetworksIf the Network Quality Indicator shows “Poor,” this indicates that you may be: • Between cellular towers.• Experiencing adverse weather conditions.• Nearing the maximum range of the closest tower.

If possible, move closer to the tower.

Indicator Icon

Good

Fair

Poor

Unknown


CounterPath Corporation Advanced Calling Options

4 Advanced Calling Options

With Bria’s advanced calling options, you can:• Navigate away from an active call (page 26).• Return to an active call (page 27).• Place a second call (page 28).• Swap between calls (page 33).• Conference call (page 34).• Transfer a call (page 35).• Record a call (page 40).• Change the audio output (page 43).• Voice mail (page 44).• Change SIP Accounts (page 45).• Deal with an auto attendant (page 48).

4.1 Navigate Away From a CallWhile on a call, you can navigate away from the call screen to any of the tabs on the resource panel or you can put Bria in the background.

Tap the Android Back, Home, or Overview button to navigate away from the call.

Back Home Overview Back Home Overview



4.2 Return to an Active Call

Background1. Open the Android navigation center.

2. Tap on the Call In Progress notification.

Bria opens and returns you to the active call.

On the Lock Screen1. Tap twice on the call notification.

2. Enter you passcode.

Bria opens and returns you to the active call.

Call Heads BriaCall Heads are small, floating action buttons that contain your contact’s image or avatar and provide easier access to active calls. Tap on the Call Heads from any screen to go back to the call screen. Call Heads can be moved around your screen, even when you are not in Bria.



Call Heads indicate the call status. An active call has a Phone icon, a video call has a Video icon, and a call on hold has a Pause icon.

Go to Settings > Preferences > Call Heads to turn Call Heads ON or OFF.

A Call Head can also be used to end a call when you are not in the call screen. Drag the Call Head to the bottom of the screen. The End Call icon appears. Drop the Call Head onto the End Call icon and Bria ends the call.

If there are two calls in progress, two call heads are displayed on the screen. You can switch between calls using Call Heads.

4.3 Place a Second CallYou can place a second call when you have one call established.

Active voice call Call on holdActive video call

Call Head in Bria Call Head with Bria in the background

End call with Call Heads with Bria in the background

End call with Call Heads in Bria



Using the Dial Pad1. Tap the Hold icon to put the first call on hold.

2. Tap the Add Call icon.


4. Tap after entering the number or tap on the contact you want to call.

Bria connects the second call. If you end one of the calls, Bria automatically switches to the other call.



Using Bria’s Contacts1. Tap the Hold icon to put the first call on hold.

2. Tap the Android Back button and go to the Contacts tab on the resource panel.


4. Tap the number you want to call.

5. Tap the Call Phone prompt.




Using Call History - Call Details1. Tap the Hold icon to put the first call on hold.

2. Tap the Android Back button and go to the History tab on the resource panel.

3. Tap the history entry containing the contact you want to call.

4. Tap the number with the Phone icon beside it.




Using Call History - Phone IconIf Settings > Preferences > Single Touch to Call is ON and Settings > Accounts (SIP) > Account Specific Fea-tures > Enable Video and Settings > Preferences > Enable Video are OFF, you do not need to tap the Call prompt to complete the call.

1. Tap the Hold icon to put the first call on hold.


3. Tap the Phone icon beside of the history entry.

4. Tap the Call prompt from Choose call type.

Bria connects the second call. If you end one of the calls, Bria automatically switches back to the other call.



Using Call History - Long Press1. Tap Hold to put the first call on hold.


3. Long press the history entry containing the contact you want to call.

4. Tap the Call prompt.

Bria connects the second call. If you end one of the calls, Bria automatically switches back to the other call.

4.4 Swap Between CallsYou can swap between calls when you have two calls established (see “Place a Second Call” on page 28).



Tap the Swap Calls icon.

Bria places the first call on hold and connects the second call. Bria displays the name of the remote party for the active call.

4.5 Conference CallsWhen you have two calls established (see page 28), you can merge the two calls into a three way conference call and you can split them back to two separate calls.

Merge CallsTap the Merge icon to merge the two established calls. Bria displays Conference.

Bria merges the calls into a conference call. If you end the call, both remote parties are disconnected. The remote parties cannot continue the call without you.



Split CallsTap the Split icon to split the two calls. Bria displays the name of the remote party for the active call.

Bria splits the calls. Bria displays the name of the remote party for the active call.

4.6 Transfer a CallCalls can be transferred to a second party in two ways. In an attended transfer, the first party speaks to the sec-ond party before transferring the call. In an unattended (blind) transfer, the first party sends the call to a second party without talking to the second party in advance.

Attended Transfer1. Use any method to establish a second call to the party you are transferring the call to (see “Place a Second

Call” on page 28).

2. When you have finished speaking, tap More.

3. Tap the Transfer to other call prompt.

Bria connects the second party to the remote party. Bria disconnects you from the both calls.



Unattended (Blind) Transfer Using the Dial Pad1. Tap More.

2. Tap Transfer to... prompt.

3. Enter the number you want to transfer the call to or enter the name you want to transfer the call to. (Use 2 for A, B, C; use 3 for D, E, F; etc.) To clear the entry, tap the X. Bria brings up a list of matches and refines the list as you enter numbers and characters.

4. Tap the Transfer icon after entering the number or tap on the contact you want to transfer the call to.

Bria puts the remote party on hold while dialing the second party. If the second party accepts the call, Bria dis-connects you from both calls. If the second party does not answer or declines the call, the call continues between you and the remote party.



Unattended (Blind) Transfer Using Contacts1. Tap Hold to put the first call on hold.

2. Tap the Android Back button and go to the Contacts tab on the resource panel.


4. Tap the number you want to transfer the call to.

5. Tap the Transfer Call prompt.

If the second party answers the call, Bria connects the second party to the remote party and Bria disconnects you from the both calls. If the second party does not answer or declines the call, the call continues between you and the remote party.



Unattended Transfer Using Call History - Call Details1. Tap Hold to put the first call on hold.


3. Tap the history entry containing the contact you want to transfer the call to.

4. Tap the Transfer to prompt.

If the second party accepts the call, Bria disconnects you from both calls. If the second party does not answer or declines the call, the call continues between you and the remote party.



Unattended Transfer Using Call History - Transfer Icon1. Tap Hold to put the first call on hold.


3. Tap the Transfer icon on the right side of the history entry.

Bria connects the second party to the remote party when the second party answers. Bria disconnects you from the both calls. If the second party does not answer or declines the call, the call remains an active call on hold for you.

Unattended Transfer Using Call History - Long Press1. Tap Hold to put the first call on hold.




3. Long press the history entry containing the contact you want to transfer the call to.

4. Tap the Transfer to prompt.

If the second party answers the call, Bria connects the second party to the remote party and Bria disconnects you from the both calls. If the second party does not answer or declines the call, the call remains an active call on hold for you.

4.7 Call RecordingWhen you record a call, Bria plays a call recording tone to the remote party when the recording starts.• Muting the call does not silence the tone.• If either party puts the call on hold, the recording is paused. Bria plays the call recording tone to the remote

party when the call resumes.• Bria stops recording when you are redirecting a call. Bria plays the call recording tone to the remote party

when the recording resumes.

Bria automatically ends the recording when you end the call. To pause the recording, stop recording the call and restart recording the call when you want to resume recording. Bria saves both recordings in the same file.

Record a Call1. Tap More during an established call.



2. Tap Start Recording.

Bria starts recording the call. Bria displays a small red, flashing dot and Recording to show that the call is being recorded.

Stop Recording a Call1. Tap the More icon.

2. Tap Stop audio recording.

Bria stops recording the call.



Listen to or Share a Recording1. Go to the History tab on the resource panel.

2. Tap the call with the call recording indicator.

3. Tap Listen to Call Recording or Share call recording.

4. Choose the app you would like to use.

5. Give permission to the app to access photos, media, and files on your device (if required).

6. Use the controls on the app to play or share the recording.

Bria opens the external app you choose to play or share the call recording. Follow any instructions in the chosen app.

Delete a Recording1. Go to the History tab on the resource panel.



2. Tap the call with the call recording indicator.

3. Tap Delete Recording and tap Yes.

Bria deletes the call recording and removes the recording indicator from the call log in History. The other details of the call remain in the call log.

Using a File ManagerYou can also manage call recordings using a file explorer or file manager. Bria saves the recordings under the /sdcard/Bria folder of the device in the WAV format.

4.8 Change the Audio OutputBria can play audio through the Android device device, over the speaker phone, or through supported accesso-ries (see “Supported Accessories” on page 2).



If you only have two audio outputs option, tap the Speaker icon to turn speaker phone. The speaker icon dis-plays the Bluetooth symbol if there are Bluetooth devices paired with the Android.

When you have two or more audio output options, tap the Speaker icon and select your preferred audio output.

4.9 Voice MailIf your VoIP service provider offers a voice mail service, incoming calls go to voice mail if: • You have voice mail configured in Settings > Accounts (see “Set Up a SIP Account” on page 7) and• You are currently on a native call.• Bria is not running.• You already have two calls established.

A voice mail indicator shows on the Android device status bar when you have a voice mail.

Access Voice Mail1. Go to the Phone tab on the resource panel.



2. Tap the voice mail icon.

Bria dials you voice mail number. Follow any instructions to play your voice mail message.

4.10 Change SIP AccountsIf you have more than one SIP account enabled, you can change the account to use on a given phone call. The primary SIP account is displayed under Phone Ready.

Using the Dial Pad - PermanentThis method permanently changes the your primary SIP account.


2. Tap . This icon will only display if you have more than one SIP account registered.

3. Tap the SIP account you want to use from Select Dial-out Account.



Bria displays the chosen account under Phone Ready. All calls will now be placed using the chosen dial-out account.

Using the Dial Pad - TemporaryThis method changes the SIP account for the outgoing call only.



3. Long press the Dial icon.

4. Tap the SIP account you want to use from Select Dial-out Account.

Bria complete the call using the dial-out account you chose.



Using Bria’s Contacts - TemporaryThis method changes the SIP account for the outgoing call only.



3. Tap the number you want to call.

4. Tap .

5. Tap the SIP account from Select Dial-out Account.



You can now tap the Call Phone or Video prompt to complete the call. Bria displays the new SIP account above the Call Phone prompt.

4.11 Pause Dialing for Auto AttendantIf you know that your call will be answered by an auto attendant and you know what menu items to choose, you can include those menu items (DTMF) in the phone number when you dial it.

Guidelines• You must include at least one comma before the first DTMF number.• You can include other commas. Each comma causes Bria to pause for one second before sending the next

character.• You must include a semicolon at the end of the input.

Example 1: To dial a number, add a 3-second delay and then press 44, enter this dialing string in the call entry field:

6045551212,,,44;

Example 2: To dial a number, add a 6-second delay, then press 1 then 3 then 2, each with a two second delay, enter this dialing string in the call entry field:

6045551212,,,,,,1,,3,,2;

NOTE: You can save the number in this format in your contacts. Tap in the entry field to bring up the keyboard.


CounterPath Corporation Call History

5 Call History

In History, you can:• View call information (see page 50).• Delete call log entries (see page 51).• Add or edit contacts (see page 52).• Call, video call, or message a number in the History (See “Place a Voice or Video Call” on page 14 or

“View and Reply to an IM” on page 79).

5.1 View Call Information1. Go to the History tab on the resource panel.

2. Tap the entry to view more information about the call.

Bria displays the type of call, the date and time of the call, the length of the call, the SIP account used, and contact information about the caller.



Call Type Icons

5.2 Delete Call Log Entries

Using Call Details1. Go to the History tab on the resource panel.

2. Tap on the call you want to delete.

3. Tap the Delete icon in the action bar and tap Yes.

Bria deletes the call from the History.

Using Long Press 1. Go to the History tab on the resource panel.

Icon Meaning

Missed Call

Incoming Call

Outgoing Call



2. Long press on the call you want to delete.

3. Tap Remove Entry.

Bria deletes the call from the History.

Delete All Calls1. Go to the History tab on the resource panel.

2. Tap the More icon.

3. Tap Clear All Entries.

Bria deletes all the calls from the History.

5.3 Create a New Contact1. Go to the History tab on the resource panel.



2. Tap the call entry containing the new contact.

3. Tap the Add Contact icon.

4. Complete the contact details. Bria populates the phone number automatically.

5. Tap Save.

The contact appears in Bria’s Contacts and the Android contacts.

5.4 Add to an Existing Contact1. Go to the History tab on the resource panel.

2. Tap the entry containing the information you want to add to an existing contact.



3. Tap the Edit Contact icon.

4. Tap the contact or enter the name and tap the contact you want to add the number to.

5. The number will automatically populate in the contact. Edit any other contact details you want to change.

6. Tap the check mark .

The contact is updated in Bria’s Contacts and in the native contacts.


CounterPath Corporation Contacts

6 Contacts

Bria uses contacts saved on your device. Bria’s contacts are continually synchronized with your native contacts. Adding, modifying or deleting a contact from one list updates the other list.

6.1 Add a Contact1. Go to the Contacts tab on the resource panel.

2. Tap +.

3. Complete the contact details you want to include.

4. Tap the check mark.

The contact is added to Bria’s contacts and the device’s native contacts.

6.2 Edit a Contact

Using Contact Details1. Go to the Contacts tab on the resource panel.





4. Tap Edit Contact.

5. Complete the contact details.


The contact is updated in the Bria’s contact and in the device’s native contacts.

Using Long Press1. Go to the Contacts tab on the resource panel.

2. Long press the contact or tap the Search icon, enter a name, and long press the contact.



3. Tap Edit from Select option.

4. Complete the contact details.


The contact is updated in the Bria’s contact and in the device’s native contacts.

6.3 Delete a Contact

Using Contact Details1. Go to the Contacts tab on the resource panel.





4. Tap Delete and tap Yes.

The Contact is deleted and no longer shows in Bria’s Contacts or in the device’s native contacts.


2. Long press on the contact you want to delete or tap the Search icon, enter a name, and long press the contact.


The Contact is deleted and no longer shows in Bria’s Contacts or in the device’s native contacts.

6.4 FavoritesFavorites allow you easy, one-touch access to contacts you use frequently. Choose a contact’s phone number as a favorite for quick access to dial and to send IMs.



Add a Favorite - Contact Details1. Go to the Contacts tab on the resource panel.


3. Tap the .

Bria adds the contact to your Favorites list.

Add a Favorite - Long Press1. Go to the Contacts tab on the resource panel.




3. Tap Add to Favorites from Select option.


Add Favorites - Multiple Contacts1. Go to the Contacts tab on the resource panel.

2. Tap Favorites and tap +.

3. Tap the contact or start typing the name of the contact you want to add to Favorites. You can add one or more contacts.

4. Tap the check mark .

Bria adds the contact(s) to your Favorites list.



Set Call OptionsWhen you call a Favorite with more than one number, you must select the correct number to call. If this is the number you always use, set Bria to use this number for any future calls to the Favorite.


2. Tap Favorites.

3. Tap the Favorite you want to call.

4. Select Remember this choice and tap the number you want to use.

Bria uses this number for calls made to this Favorite.

Edit Call OptionsIf you no longer want to use a specific number for a Favorite, you can edit the Call Options prior to making a call.


2. Tap Favorites.

3. Long press on the contact you want to edit the Call options for.



4. Tap Call options.

5. Deselect Remember this choice and tap the number you want to call.

Bria no longer uses the specified number to call your Favorite. You will be asked to choose a number each time you call the Favorite.

Delete a Favorite - Contact Details1. Go to the Contacts tab on the resource panel.


3. Tap the .




Delete a Favorite - Long Press1. Go to the Contacts tab on the resource panel.

2. Tap Favorites.


4. Tap Remove from Favorites.

Bria removes the contact from your Favorites list. The contact remains in Bria’s Contacts.

Delete All Favorites1. Go to the Contacts tab on the resource panel.

2. Tap Favorites.




4. Tap Clear favorites.

Bria removes all the contacts from your Favorites list.

6.5 Contact FieldsSome fields can be updated in Bria’s Contacts or in the Android’s contacts. These fields include:• First name / Given name• Last name• Company• Photo• Softphone• Phone• Email

There are some fields that can only be updated through the Android’s contacts app. Not all of these fields will appear in Bria. These fields include:• Name Prefix• Middle Name• Name Suffix• Phonetic Name• Nickname• Title• Address• Instant Message• Website• Date (Birthday, Anniversary, Other, Custom)• Relationship• Notes• Label


CounterPath Corporation Presence and Messaging

7 Presence and Messaging

With Presence and Messaging, you can:• Share your online status (presence).• Exchange instant messages (IMs) with contacts who have a softphone number or an XMPP address.• Send an SMS from a SIP account to PSTN mobile phone numbers if your VoIP service provider supports

this feature.

Presence and Messaging is available as an In-app purchase. If you plan to use SIP SIMPLE for Presence and Messaging, make sure your VoIP service provider supports SIP SIMPLE before purchasing this option. To purchase, see “Purchase a Premium Feature” on page 111.

7.1 PresencePresence allows you to share your online status with contacts who have a softphone number or an XMPP address. When you launch Bria, your online status is Available. Go to the Messaging tab on the resource panel to view your status.

You can change your status from Available to Away, Busy, Do Not Disturb, On The Phone, or Appear Offline. You can also set a custom status note. Bria updates your status to On The Phone when you make or receive a phone call if your status is Available and you have not created a custom status note. When you have no accounts registered, you status appears as Offline.

Presence OptionsStatus My Presence Means that...

Available People can call you and send you an IM. If no custom status note is specified, Bria automatically switches from Available to On The Phone when you make or receive calls.

Away People can call you and send you an IM.

Busy People can call you and send you an IM.

Do Not Disturb (DND)

No one can call you; the call fails and your call history shows a missed call. Your Buddies can send you IM; an alert comes up on the Messaging tab without any sound.

On The Phone When you make or receive phone calls, Bria automatically updates your status to On The Phone if your status is Available and no custom note is specified. When your call finishes, your status goes back to “Available”.While you are on the phone, you can still send and receive IMs.

Appear Offline You can see your Buddies’ presence, but your Buddies see you as offline. You receive phone calls and IMs if your Buddies do contact you; they are unlikely to do so because your Buddies cannot tell the difference between Appear Offline and you really being offline.

My Custom Status Note

You can choose any of the other status options. Your Buddies see the Status icon with your custom status note.



Change Your Status1. Go to the Messaging tab on the resource panel.

2. Tap on the symbol beside your presence. The list of available status options appears.

3. Tap the status option you want to use.

4. Tap the Back icon.

Bria updates your status.

Create a Custom Status1. Go to the Messaging tab on the resource panel.

2. Tap on the symbol beside your status. The list of available status options appears.



3. Tap <Enter Custom Note>, enter your custom status, and tap the check mark on the keypad or tap the Android Back button.


Bria updates the text in your status to your My Custom Status Note. You can choose any of the status options available. Your Buddies see the wording from My Custom Status Note and the status symbol from the status you choose.

Delete a Custom Status1. Go to the Messaging tab on the resource panel.

2. Tap on the symbol beside your status. The list of available status options appears.



3. Tap the X beside your Custom Note.


Bria removes the text in your status from your My Custom Status Note. Your Buddies see the wording and the status symbol from the status you choose.

7.2 BuddiesBuddies are contacts that share their online status with you.

To view someone’s online status, you need to add the person as a Buddy. A Buddy must have an XMPP address or a softphone number. An XMPP address and a softphone number are typically a username.

When you add a SIP Buddy, you see your Buddy’s presence as soon as you register your Buddy’s softphone number on the client. Your Buddy will see your presence as soon as they register your softphone number on their client.

When you add an XMPP Buddy, Bria sends a Buddy request. When your Buddy request is accepted, you see your Buddy’s status. If your Buddy request is denied, the person remains in your Buddies list with Blocked status. Your Buddy does not see your status until you accept their Buddy request.

7.3 Add a BuddyWhen you use SIP SIMPLE for Presence and Messaging, your Buddies are stored locally as an im uri SIP URI address. You need to manually add Buddies. These Buddies appear with presence in your Buddies list and without presence in Bria’s Contacts and the device’s contacts.

For XMPP accounts, your Buddies are stored in an XMPP server or roster, not in your local Android device contacts. The name and presence of your Buddies appear in your Buddies list when your XMPP account is connected. Buddies do not show up in your Bria Contacts or the device’s contacts.



SIP SIMPLE - Add a New Contact1. Go to the Contacts tab on the resource panel.

2. Tap Buddies and tap +.

3. Select your SIP account if both SIP and XMPP accounts appear. The SIP account has the icon beside it.

4. Complete any contact fields you want.

5. Tap the green plus icon, change the Phone Type to Softphone, and enter the Buddy’s softphone address. The address is typically the username of the Buddy.

6. Tap the Android Back button.

7. Tap Presence and IM and select the Softphone Address.


The new Buddy appears with presence in Bria’s Buddies list and in Contacts without presence.



SIP SIMPLE - Edit an Existing Contact Using Contact Details 1. Go to the Contacts tab on the resource panel.



4. Tap Edit Contact.





The Buddy appears with presence in Bria’s Buddies list and remains in Contacts.



SIP SIMPLE - Add an Existing Contact Using Long Press1. Go to the Contacts tab on the resource panel.


3. Tap Edit from Select option.







The Buddy appears with presence in Bria’s Buddies list and remains in Contacts.

XMPP - Add a BuddyMake sure your XMPP account is connected to an XMPP server.


2. Tap Buddies and tap +.

3. Select your XMPP account if both SIP and XMPP accounts appear. The XMPP account has the icon beside it.

4. Enter the user portion of the jabber jid in Username and the enter Display name (optional).

5. Tap Done.

The Buddy appears in Bria’s Buddies list only. Once the Buddy accepts your request, you see the Buddy’s presence.

7.4 Delete a Buddy - SIP and XMPPSIP Simple Buddies and XMPP Buddies are deleted the same way.

For XMPP, make sure your XMPP account is connected to an XMPP server.



Using Buddy Details1. Go to the Contacts tab on the resource panel.

2. Tap Buddies.

3. Tap the Buddy you want to delete or tap the Search icon, enter a name, and tap the Buddy you want to delete.



Bria removes the SIP SIMPLE Buddy from your Buddies list. The person remains in Bria’s contacts and the Android’s native contacts without presence.

Bria completely removes the XMPP Buddy from Bria’s Buddies list and from the XMPP server.




2. Tap Buddies.

3. Long press the Buddy or tap the Search icon, enter a name, and long press the Buddy.


Bria removes the SIP SIMPLE Buddy from your Buddies but leaves the person in your Contacts in Bria and the native contacts without presence.

Bria completely removes the XMPP Buddy from Bria’s Buddies list and from the XMPP server.

7.5 Buddy RequestsWhen using a SIP account for presence, you do not send and receive a Buddy requests. As soon as the person on the other end registers your softphone number on the client, the person sees your presence without your acceptance. Similarly, you see someone’s presence right away without having to wait for the person’s response.

You can respond to the request in one of three ways: • Accept: Let the other person see your online status. At the same time, a Buddy request is automatically sent

from Bria to this person, and you see this person’s status in Bria’s Buddies list.• Ignore: The person does not see your online status. The Buddy request may appear in this session or in a

future session.• Decline: The person does not see your online status. You do not see this person on Bria’s Buddies list.



Respond to a Buddy RequestWhen you have a new Buddy request, you see a notification in the Android status bar and a badge notification on the Contacts tab in Bria.

1. Go to the Contacts tab on the resource panel or swipe down on the Android status bar and tap on the New Request notification.

2. Tap Buddies and if Requests is not selected in the drop down list, tap Requests. The requests tab only appears when you have a Buddy request.

3. Tap on the Buddy request.

4. Tap Accept, Ignore, or Decline.

Bria sends your status to the remote party if you accept the request.

7.6 Send an IMYou can send an IM to a Buddy who is online. If you do not have any Buddies yet, see “Add a Buddy” on page 68.

To add a new line in an IM message, tap the More icon, tap Canned IM and select Enter a new line.



Using Messaging1. Go to the Messaging tab on the resource panel.

2. Tap IM if SMS and IM both appear.

3. Tap the yellow plus sign.

4. Tap the contact or tap search , enter a name and tap the contact.

5. Tap the yellow check mark.



6. Tap inside the message area, type your message, and tap the Send icon.

Bria sends the IM.

Using Contacts - SIP Buddy1. Go to the Contacts tab on the resource panel.

2. Tap or long press the contact or tap the Search icon, enter a name, and tap or long press the contact.

3. Tap Send Instant Message when you tap a contact or tap More and tap Send IM from the menu when you long press a contact.




Bria sends the IM.

Using Contacts - XMPP Buddy1. Go to the Contacts tab on the resource panel.

2. Tap Buddies.

3. Tap or long press the contact or tap the Search icon, enter a name, and tap or long press the contact.



4. Tap Send Instant Message when you tap a contact or tap More and tap Send IM from the menu when you long press a contact.


Bria sends the IM.

7.7 View and Reply to an IMWith Bria running, you can reply to an IM when Bria is in the foreground, background, or the device is locked.

Foreground Bria displays the number on new IMs on the resource panel.

1. Go to the Messaging tab on the resource panel.

2. Tap the IM with a message indicator beside it. The new message and any previous messages in the conversation open in the content panel.




Bria sends the IM.

Background When Bria is in the background, you see a notification in the Android status bar when you have a new IM.

1. Swipe down on the Android status bar.

2. Tap the notification. The conversation opens in Bria.


Bria sends the IM.

Notification in the Android status bar



Device is Locked When the Android is locked, you receive a notification on the home screen when you have a new IM.

1. Tap the notification twice and enter your passcode. The conversation opens in Bria.


Bria sends the IM.

Pre-Defined Canned MessagesBria offers pre-defined messages so you can quickly respond to an IM. The messages are:

• Are you there?• Have time to call?• Have time to chat?• Busy... I’ll IM you later.• Busy... I’ll call you later.• Driving... I’ll IM you later.• Driving... I’ll call you later.




2. Tap the message you want to respond to.

3. Tap the More icon and tap Canned IM.

4. Tap the canned message you want to use and tap the Send icon.

Bria sends the canned message.

7.8 Send an SMSYou can send an SMS from your SIP account to PSTN mobile phone numbers if your VoIP service provider supports this feature. Turn ON Settings > Preferences > Enable SMS and Settings > Accounts (SIP) > Account Specific Features > Enable SMS.

Using Messaging1. Go to the Messaging tab on the resource panel.



2. Tap SMS if SMS and IM both appear.


4. Tap the contact or tap in the search bar, enter a name and tap the contact.


Bria sends the SMS.

Using Contacts1. Go to the Contacts tab on the resource panel.




3. Tap the PSTN number you want to send an SMS to.

4. Tap the Send SMS prompt.


Bria sends the SMS.

7.9 XMPP Group ChatYou can host a group chat using your XMPP account on Bria when the following requirements are met:• Your XMPP server must support Multi User Chat extension, as defined in XEP-0045.• All the clients must support XEP-0045. For example, users with the previous version of Bria cannot join a

group chat.• All users must connect to the same XMPP server, and their XMPP accounts must have the same domain.

How XMPP Group Chat WorksIn a group chat, a host and selected Buddies can share messages.

The host starts the group chat and sends an invitation message to all the selected Buddies. Once the invitation is sent, the host cannot remove any of the participants.



Once a group chat becomes available, the chat remains active until everyone leaves the chat. Participants can leave the group chat and return, if the chat is still active.

Bria downloads the undelivered messages from the XMPP server and displays them in the chat history, which are saved locally on Bria. Participants can view the history even when the XMPP account is unregistered.

Create a Group Chat1. Go to the Messaging tab on the resource panel.



4. Tap the contacts or tap search , enter a name, and tap the contacts you want to add to the group chat. Selected participant have a check mark over their avatar. To remove a selected participant, tap the participant and tap the X beside their name or tap the check mark over their avatar.





Bria sends the IM.

Add a ParticipantYou can add a new participant to an existing one-on-one or group chat.



3. Tap the chat you want to add a participant to.

4. Tap the Add Participant icon.

5. Tap the contact or tap search, enter a name, and tap the contact you want to add to the group chat. Repeat for all the contacts you want to add to the chat. Selected participants have a check mark over their avatar. If you need to remove a selected participant, tap the participant and tap the X beside their name or tap the check mark over their avatar.

Add participant to one-on-one IM. Add participant to group chat.





Bria sends the IM.

Join a Group ChatWhen you are invited to a group chat, the invitation message comes to your XMPP account as a regular message. You are automatically placed into the group chat once you receive the message.

Leave a Group Chat Once a group chat becomes available, the chat remains active until everyone leaves the chat. Participants can leave the group chat and return, if the chat is still active.

Unregister Your XMPP AccountUnregister your XMPP to leave all group conversations.

1. Go to the Settings tab on the resource panel.

2. Toggle the XMPP account switch to OFF.

Your XMPP account is unregistered and Bria removes you from all group chats. Make sure to toggle the account switch ON to use your XMPP account again.

Delete a ConversationDeleting a group chat on the Messaging tab lets you leave the chat. You will not be able to come back to the chat or view the chat history.





3. Long press the conversation you want to delete.

4. Tap Delete IM Session.

Bria deletes the group chat.

7.10 Delete, Copy, or Forward MessagesYou can delete, copy, or forward a single message or multiple messages.


2. Tap SMS or IM depending on the type of message.

3. Long press a message you want to delete, copy, or forward.

4. Tap all other messages your want to delete, copy, or forward. Selected messages are highlighted in gray.



5. Tap the Delete icon, the Copy icon, or the Forward icon.

6. To delete messages, tap Yes. To forward messages, tap the contact or search for the name and tap the contact you want to forward the message to.

Delete: Bria deletes the selected messages.

Copy: Bria copies the selected messages to the clipboard. You can paste messages in Bria or in another app.

Forward: Bria groups the selected messages into one new message and forwards them to the selected contact.

Use Emoticons/EmojiBria supports the Android Emoji keyboard. If your Android device has the Emoji keyboard, switch keyboards by taping of the smiley face icon on the keyboard. To switch back the alphanumeric keyboard, tap the ABC icon.

Bria also supports the following keyboard shortcuts to display emoticons.

Change to emoticon keyboard Change to alphanumeric keyboard



Icon Typing Meaning

:) Happy

:-D Big grin

:-( Sad

;-) Winking

:-P Tongue out

:-| Speechless


CounterPath Corporation Settings

8 Settings

This section describes the settings that appear in:Accounts – see page 91.

SIP Accounts – see page 91.Account Specific Features – see page 92.Account Advanced – see page 93.Dial Plan (Numbered Prefixes) – see page 96.

XMPP Accounts – see page 96.Account Specific Features – see page 97.Account Advanced – see page 97.

Network Traversal – see page 98.Custom DNS Servers – see page 100.

Preferences – see page 101.

Advanced Settings – see page 105.

Premium Features – see page 110.

Share – see page 112.

8.1 AccountsGo to Settings > Accounts to make changes in the following fields.

Accounts (SIP)All the fields on this screen must be supplied by your VoIP service provider.

Field Description

Account Name Enter a name for each account to identify different accounts when you have multiple accounts.

USER DETAILS

Display As Your name. Other people may see this as the caller ID (or they may see just your phone number).

Username User portion of your SIP Address of Record (AOR). For example, if your account is [email protected], the username is “6045551234”Provided by your VoIP service provider. Do not enter a domain name here.

Password The password for your SIP account.Provided by your VoIP service provider.



Account Specific Features (SIP)

Domain If your account is [email protected], the domain is myVoIPProvider.Provided by your VoIP service provider.

VOICE MAIL

VM Number The phone number for accessing voice mail. If there is a number in this field, tap VM on the Dial Pad to access your voice mail.Provided by your VoIP service provider. (See “Set Up a SIP Account” on page 7.)

ACCOUNT EXTRAS

Account Specific Features See “Account Specific Features (SIP)” on page 92.

Account Advanced See “Account Advanced (SIP)” on page 93.

Dial Plan (Number Prefixes) Optional. See “Dial Plan (Number Prefixes)” on page 96.

Field Description

MOBILE DATA NETWORK

Disable Mobile Data Appears when Settings > Preferences > Use When Available is ON.• ON: This account does not use mobile data to register for SIP service when a Wi-Fi network is not

available and Bria is on a mobile network. You cannot receive any messages or notifications on this SIP account when Wi-Fi is not available, and you cannot place or receive calls without Wi-Fi.

• OFF: Bria attempts to place and receive calls on this account when a Wi-Fi network is not available.

Data charges with your mobile carrier may apply.

Disable VoIP Calls Appears only when Settings > Preferences > Allow VoIP Calls is ON and Settings > Accounts > Account Specific Features > Disable Mobile Data is OFF.• ON: No VoIP calls can be made on this SIP account when a Wi-Fi network is not available and Bria

is on a mobile network.• OFF: Bria attempts to place and receive calls on this SIP account when a Wi-Fi network is not

available.


VIDEO CALLS

Enable Video Available when Settings > Preferences > Enable Video is ON.You must purchase the Video Calls premium feature to place and receive video calls. (See “Purchase a Premium Feature” on page 87.)• ON: Make and receive video calls on this SIP account.• OFF: You cannot make and receive video calls on this SIP account.

Always Offer Video Appears when Settings > Accounts > Account Specific Features > Enable Video is ON.• ON: Always offer video to the remote party whether you use the Dial Pad, the Contacts tab, or the

History tab.• OFF: (default): Dial a number with audio offer.

Auto Send Video Appears when Settings > Accounts > Account Specific Features > Enable Video is ON.• ON: Bria automatically starts sending video when you receive video calls.• OFF (default): Video does not start until you tap you manually add video.

Field Description



Account Advanced (SIP)

IM AND PRESENCE

Enable IM and Presence Available when Settings > Preferences > Enable IM and Presence is ON.You must purchase the Presence and Messaging premium feature to use IM and Presence. (See “Purchase a Premium Feature” on page 111.)• ON: Share your online status with and send instant messages to your Buddies.• OFF: Do not share you online status and send IMs with your Buddies.

Presence Agent Appears when Settings > Account Specific Features > Enable IM & Messaging is ON.ON: Enable this setting if the SIP server supports Presence Agent for SIP SIMPLE.OFF: Default

Publish Refresh Appears when Settings > Account Specific Features > Enable IM & Messaging is ON.Interval for publishing your status over SIP SIMPLE. • Minimum: 30 seconds• Default: 900 seconds.

Subscribe Refresh Appears when Settings > Account Specific Features > Enable IM & Messaging is ON.Interval for subscribing to your Buddy’s status over SIP SIMPLE.• Minimum 30 seconds• Default: 900 seconds.

SMS MESSAGING

Enable SMS Available when Settings > Account Specific Features > Enable IM & Messaging is ON.You must purchase the Presence and Messaging premium feature to use IM and Presence. (See “Purchase a Premium Feature” on page 111.)• ON: Send an SMS to PSTN cell phone numbers by using the SIP SIMPLE protocol. Turn ON if

your VoIP service provider supports this feature.

Split Longer Messages Appears when Settings > Account Specific Features > Enable SMS is ON.Controls how a long SMS is split — either the client side or the server side. You can type a long message on Bria regardless of this setting. Turn this ON if your SIP server does not accept/split long SMS.• ON: Bria splits a long message to multiple SMS messages and sends them to the SIP server.• OFF (default on the server side): Bria sends a long message to the server and lets the server split it

into multiple SMS.

Field Description

DEFAULT NETWORK TRAVERSAL

Current Strategy See “Network Traversal” on page 98.

Preferred Network Interface • VPN: Force Bria to select the VPN network interface. Choose this option only if you are using Bria with a VPN connection to your network; otherwise, the wrong network interface my be selected, resulting in registration problems.

• Default: You are not using a VPN network interface. Select the interface if you encounter any issues using VPN.

ACCOUNT ADDITIONAL

Out. Proxy Complete this field only if your SIP provider gave you an outbound proxy address, typically a domain name or an IP address.

Authorization Name Complete this field only if your SIP provider gave you an authorization name. Most providers do not use this field.

Field Description



IP VERSION SELECTION

Wi-Fi IP Version Specifies the IP version for DNS lookup and SIP signaling. Applies to Wi-Fi networks. This does not apply to HTTP/S connections such as login and provisioning. Bria leverages the Android native HTTP/S framework for these connections.• IPv4: Bria uses IPv4 and does not look for IPv6 at all• IPv6: Bria uses IPv6 and does not look for IPv4• Prefer IPv4: Bria uses IPv4 first if it detects both IPv4 and IPv6• Prefer IPv6: Bria uses IPv6 first if it detects both IPv4 and IPv6

Mobile IP Version This settings has the same function as Wi-Fi IP Version except it applies to mobile data networks.

DTMF TYPE

Send DTMF using The method used to send DTMF. DTMF is sent when you press a number key when you are dealing with an auto attendant, such as “press 1 for customer service”.If DTMF tones are not being recognized, try the other methods to resolve the issue. If DTMF is still not working, contact your VoIP service provider. Choose a method specified by your VoIP service provider: • RFC 2833 (Default) • SIP Info• Inband

If Bria recognizes that RFC 2833 or SIP INFO fails, it sends Inband instead.

TRANSPORT AND SECURITY

SIP Transport Contact your VoIP service provider to identify the types of transport that are supported. Most VoIP service providers only support UDP transport.• UDP: Turn Settings > Preferences > Run In Background ON to receive incoming calls when

Bria is in the background.• TCP: Allows you to take advantage of multi-tasking support such as receiving incoming calls

when Bria is sleeping in the background. This preserves battery.• TLS: Supports signal encryption if it is supported by your VoIP service provider. If TLS is

selected, a given call is encrypted if the other person also uses TLS. You may need to install a certificate on your Android device; contact your VoIP service provider. Also allows you to take advantage of multi-tasking support such as receiving incoming calls when Bria is sleeping in the background. This preserves battery.

• Auto: Bria selects the SIP transport type.

Encrypt Audio Encrypt a phone call at the media (audio) level using SRTP. Encrypting audio is subject to VoIP service provider support.• Never (default): Audio is not encrypted.• Always: Audio is always encrypted. The call fails if the other person cannot accept encrypted

calls. Call media encrypted shows during a call.

Field Description



TLS CERT MANAGEMENT

Verify TLS Cert • ON: (default) Bria attempts to verify the certificate sent by the SIP server to see if it is trusted. • OFF: Bria accepts the certificate without attempting to verify it.

It depends on how your service provider handles TLS certificates whether you need to take an extra step to make this work.• If the certificate has been trusted by well-known certificate authorities (such as VeriSign), you

do not need to take further action.

If the certificate is a self-signed certificate, you need to install a corresponding CA certificate on the device in advance so Bria can verify a cert (received from the SIP server) against the CA certificate. Contact your VoIP service provider to get the corresponding CA certificate and save it to your device. Enter the CA certificate in Android Settings > Security > Credential Storage.The CA cert should appear under Android Settings > Security > Credential Storage > Trusted credentials.

SIP REGISTRATION

Incoming Calls • ON: This account can be used to make outgoing calls and receive incoming calls.• OFF: This account can only be used to make outgoing calls.

Wi-Fi Refresh Interval The timer interval for Bria’s attempts to register in order to refresh SIP account registration when on a Wi-Fi network. This value is placed in the “Expires” header field of the SIP Register message.Change this value only if advised to do so by your VoIP service provider.• Range: 30 to 900 seconds• Default: 900 seconds

Mobile Refresh Interval This settings has the same function as Wi-Fi Refresh Interval except it applies to mobile data networks.

CALL DIALING

Use Tel URI Change this value only if advised by your VoIP service provider. Some providers may require the tel:// format.• ON: Prefix SIP URIs with tel://• OFF (default): Prefix SIP URIs with sip://

Strip Foreign Domain • ON: Bria removes the domain portion of the IP address if an inbound call has a different domain than yours and the username portion of the IP address is digits only. Log entries and history and contacts created from the log entries will store the username digits only. Try turning this setting ON if you receive a “403 – Not relaying” response to an outbound call.

• OFF (default)

SIP MISCELLANEOUS

Wi-Fi NAT64 Support Leave ON if there is a possibility that Bria is going onto an IPv6-only network trying to reach IPv4-only SIP services/infrastructure over a Wi-Fi network• Requires that the configured name servers support DNS64• Requires a Session Border Controller (SBC) with latching support, or a STUN server. ICE is

not supported.• This feature is typically not necessary on platforms/networks where alternative IPv4-to-IPv6

transition mechanisms are used, such as 464XLAT.

Has no effect when Bria uses IPv4 to communicate with the SIP server (Settings > Account Advanced > Wi-Fi IP Version is set to IPv4.)• ON: If Bria detects an IPv6-only network, it tries to use DNS64 to translate IPv4 addresses

into IPv6 addresses.

Mobile NAT64 Support This settings has the same function as Wi-Fi NAT64 Support except it applies to mobile data networks.

Field Description



Dial Plan (Number Prefixes)

Accounts (XMPP)All the fields on this screen must be supplied by your XMPP service provider.

Passive Session Timer Controls the use of session timers on SIP accounts. The session timer is used to determine if the call is still active.Only choose OFF if advised by your VoIP service provider.• ON (default): Bria does not use session timers in any session, except if it is explicitly required

by the remote party.• OFF: Bria uses session timers in all sessions whenever the remote party supports and uses it.

Enable IMS Only choose ON if advised by your VoIP service provider.• ON: Bria supports the IP Multimedia System. Bria populates the authorization header upon

every SIP request immediately instead of after a challenge. Bria uses the SIP account domain for authorization realm.

• OFF: Default

Enable PRACK • ON: Bria advertises that it supports ‘100rel’and allows PRACK, as defined in RFC 3262. The outgoing INVITE message has ‘100rel’ in the Supported header and ‘PRACK’ in the Allow header.

• OFF: (default) Bria does not advertise these features.

KEEP ALIVE

Wi-Fi Interval A keep alive message maintains a pinhole through your firewall so that the account registration is maintained over a Wi-Fi network. The interval specifies how often the message is sent (in seconds).If you are experiencing problems — for example, accounts become unregistered when using a Wi-Fi connection — try setting this interval to a lower number such as 20 seconds.Specify 0 to disable.

Mobile Interval This settings has the same function as Wi-Fi Interval except it applies to mobile data networks.

CUSTOM DNS SERVERS

DNS Servers See “Custom DNS Servers” on page 100.

Field Description

Match Number The pattern to be matched.

Remove Prefix The prefix to remove if the number matches the rule.

Add Prefix The prefix to add if the number matches the rule.

Number To Test Enter a test number that starts with the Match Number.

Resulting number to dial Displays the number that will be dialed after applying the dial plan rule.

Field Description



Before you make changes to an existing account in Settings > Accounts (XMPP), turn the account toggle switch OFF. Turn the slider beside the account ON when you have finished making changes.

Account Specific Features (XMPP)Available when Settings > Preferences > Use When Available is ON.

Account Advanced (XMPP)

Field Description

Account Name Enter a name for each account to identify different accounts when you have multiple accounts.

USER DETAILS

Username The username for your XMPP account.

Password The password for your XMPP account.

Domain Domain of the XMPP service.

Account Specific Features See See “Account Specific Features (XMPP)” on page 97..

Account Advanced See See “Account Advanced (XMPP)” on page 97..

Field Description

MOBILE DATA NETWORK

Disable Mobile Data • ON: This account does not use mobile data when a Wi-Fi network is not available. You will not receive any messages or notifications when a Wi-Fi network is not available.

• OFF: Bria uses mobile data to receive messages and notifications when a Wi-Fi network is not available. Data charges with your mobile carrier may apply.

Field Description

ACCOUNT ADDITIONAL

Outbound Proxy Complete this field only if your XMPP service provider has an outbound proxy and requires you to provide that address to Bria. Enter the domain name or the IP address obtained from your provider.

Resource Used to identify an XMPP session when you log in to multiple clients with this XMPP account (for example, /work or /home). Can be used to allow one XMPP session at a time. The default is not set.

Priority Informs the XMPP server about the priority of your XMPP session. • Expected range: -128 to 127• Default: 0.

Account toggle switch ON

Account toggle switch OFF



Network TraversalThe Network Traversal Strategy can be found in Settings > Accounts (SIP) > Account Advanced. You can con-figure separate NAT settings for each SIP account, such as STUN, ICE, TURN, and RPort.

Before you make changes in Settings > Accounts (SIP) > Network Traversal Strategy, turn the account toggle switch OFF. Turn the slider beside the account ON when you have finished making changes.

IP VERSION SELECTION

Wi-Fi IP Version Specifies the IP version for DNS lookup and XMPP connections. Applies to Wi-Fi networks. This does not apply to HTTP/S connections such as login and provisioning. Bria leverages the Android native HTTP/S framework for these connections.• IPv4: Bria uses IPv4 and does not look for IPv6 at all• IPv6: Bria uses IPv6 and does not look for IPv4• Prefer IPv4: Bria uses IPv4 first if it detects both IPv4 and IPv6• Prefer IPv6: Bria uses IPv6 first if it detects both IPv4 and IPv6

Mobile IP Version This settings has the same function as Wi-Fi IP Version except it applies to mobile data networks.

TLS CERT MANAGEMENT

Verify TLS Cert • ON: (default) Bria attempts to verify the certificate, sent by the XMPP server, to see if it is trusted.

• OFF: Bria accepts the certificate without attempting to verify it.

It depends on how your service provider handles TLS certificates whether you need to take an extra step to make this work.• If the certificate has been trusted by well-known certificate authorities (such as VeriSign), you

do not need to take further action.

If the certificate is a self-signed certificate, you need to install a corresponding CA certificate on the device in advance so Bria can verify a cert (received from the XMPP server) against the CA certificate. Contact your VoIP service provider to get the corresponding CA certificate and save it to your device. Enter the CA certificate in Android Settings > Security > Credential Storage.The CA cert should appear under Android Settings > Security > Credential Storage > Trusted credentials.

KEEP ALIVE

Use Ping • ON (default): Send ping messages to the XMPP server to indicate that the connection is active.

Interval Interval for the ping messages to be sent to the XMPP server (in seconds) to indicate that the connection is still active.• Default: 300 seconds.

Field Description

DEFAULT NETWORK TRAVERSAL

Field Description

Account toggle switch ON

Account toggle switch OFF



Strategy • Application Managed: Bria uses the specified STUN server to discover the public address of your device and presents your public address when negotiating media routing. Use DNS SRV is turned ON when strategy is set to Application manager.

• Server Managed: Bria presents the Android device’s private address for SIP signaling and when negotiating media routing. A robust SIP infrastructure, after detecting the private address, can step in and route the packets on the application’s benefit. Choose this option if your VoIP service provider advises you that it has implemented a network-hosted NAT traversal (or far-end NAT traversal) such as a session border control (SBC), media proxy, or RTP relay. Use DNS SRV is turned ON when the strategy is set to Server Manager.

• Custom Configuration: Allows you to configure the network traversal strategy for SIP signaling, STUN/TURN server, and media routing.

SIP NETWORK TRAVERSAL

RPort Wi-Fi • ON: When you are connected over a Wi-Fi network, the outgoing INVITE message has an RPort parameter inside the Via header, which indicates that Bria supports RFC3581.

• OFF: The outgoing INVITE message does not have an RPort parameter. Choose OFF if your proxy is unable to support RPort over Wi-Fi.

RPort Mobile This settings has the same function as Rport WiFi except it applies to mobile data networks.

Outbound Wi-Fi • ON: Bria uses an existing connection by populating the SIP header as specified in RFC5626. The SIP server should communicate with Bria using the same connection if the transport is set to TCP or TLS. Turn this setting ON if you have trouble connecting to the SIP server over Wi-Fi.

• OFF: Bria does not use an existing connection.

Outbound Mobile This settings has the same function as Outbound WiFi except it applies to mobile data networks.

STUN/TURN

Use DNS SRV When ON, Server, Username and Password are disabled.• ON: Bria uses DNS SRV to discover the network addresses for your VoIP service provider's

VoIP-related services (for example, a STUN server). • OFF: Bria does not use DNS SRV for discovery. Only turn this setting OFF if your system

administrator advises you to do so.

Server Appears when Settings > Accounts > Account Advanced > Network Traversal > Use DNS SRV is OFF.CounterPath recommends that you change the default (stun.counterpath.com) to an address provided by your VoIP service provider. If the Server setting is left empty, Bria tries to query your VoIP service provider for STUN server (STUN DNS SRV record on its network). The VoIP service provider may not have the server configured, which can create a delay on start up (disabling STUN can mitigate this).

Username Appears when Settings > Accounts > Account Advanced > Network Traversal > Use DNS SRV is OFF.The username to connect to the STUN/TURN server. Usually provided by your system administrator or your VoIP service provider.

Password Appears when Settings > Accounts > Account Advanced > Network Traversal > Use DNS SRV is OFF.The password to connect to the STUN/TURN server. Usually provided by your system administrator or your VoIP service provider.

MEDIA NETWORK TRAVERSAL

Field Description



Custom DNS ServersThe Custom DNS Servers are configurable under Accounts (SIP) > Account Advanced > Custom DNS Servers > DNS Servers.

Custom DNS Server is a domain name server that is specific to a given domain (network or sub-network). It provides Bria the ability to query inside the network for IP addresses associated to domain names rather than querying outside the domain. Bria queries up to 4 DNS servers sequentially from the top of the list.

Use STUN Wi-Fi This setting applies to media routing. STUN is disabled when IPv6 is used.• ON: Bria uses a STUN server to discover your public IP address over a Wi-Fi network. This

public IP is used to inform the remote party where the audio packets should be sent. Otherwise the private IP is presented.

• OFF: Bria does not discover your public IP address; only the private IP address is used. This setting is ignored and presumed OFF when VPN is enabled.

Use STUN Mobile This settings has the same function as Use STUN WiFi except it applies to mobile data networks.

Use ICE Wi-Fi ICE is involved only in media routing; it is not involved in SIP signaling.• ON: Bria uses ICE to discover addresses for media packets over a Wi-Fi network. ICE

provides a good guarantee of two-way audio. However, to use ICE successfully, both endpoints in a call must use ICE and must meet draft 19 of the ICE standard.

• OFF: Try turning ICE OFF if you are not the Android device behind a firewall or NAT.

Use ICE Mobile This settings has the same function as Use ICE WiFi except it applies to mobile data networks.

Use TURN Wi-Fi Check with your VoIP service provider to make sure a TURN server is available.• ON: Bria advertises the public IP address (discovered via STUN) for the contact address for

signaling traffic over a Wi-Fi network. Bria advertises the address of a media relay server (discovered via TURN) for the connection address for media traffic.

• OFF: TURN server is not available.

Use TURN Mobile This settings has the same function as Use TURN WiFi except it applies to mobile data networks.

Field Description



8.2 PreferencesGo to Settings > Preferences to make changes to the following fields.

Field Description

MOBILE DATA NETWORK

Use When Available • ON: Bria attempts to connect to SIP/XMPP services using the mobile data network when a Wi-Fi connection is not available. You receive messages and voice mail notifications when Bria is in the mobile data network.

• OFF: If a Wi-Fi connection is not available, SIP and XMPP services are unregistered; you will not receive any messages or notifications and will not be able to place or receive calls.


Allow VoIP Calls Appears when Settings > Preferences > Use When Available is ON. • ON: Bria attempts to place calls using the mobile data channel when a Wi-Fi

connection is not available. Voice quality may be impacted as mobile data is not ideal for voice calls. CounterPath recommends purchasing the G.729 codec for better audio quality on mobile data calls (3G/4G/LTE). See “Purchase a Premium Feature” on page 111.

• OFF: If a Wi-Fi connection is not available, you will not be able to place or receive calls.

Data charges with your mobile carrier apply.

INCOMING CALL

Play Ringtone • ON: Your Android device plays a ringtone for incoming calls.• OFF: Your Android device does not play a ringtone for incoming calls.

Vibrate • ON: Your Android device vibrates when you receive a call.• OFF: Your Android devicedevice does not vibrate when you receive a call.

Contact Image Changes the way Bria displays the image of a contact during a call when you have added an image to a contact in the Contact tab of the resource panel. Make sure your images are smaller in size so they display faster.• ON: Bria shows an image of the remote party during a call.• OFF:Bria does not show an image of the remote party during a call.

Ringtone Select the ringtone that will be used for incoming calls.

Call Heads • ON: Tap on Call Heads from any screen on your Android tablet to go back to the call screen or end a call.

• OFF: Call Heads are not available.

Decline Options Tap to set up Quick Responses and Call Reminders

Quick Response A list of pre-defined IMs that can be used when you decline a call from an XMPP Buddy on the same XMPP server.Create, edit, and delete Quick Responses.

CALL REMINDER

Enable Call Reminder • ON: Bria will ask if you want a call reminder to be set when you decline a call.• OFF: Bria will not set a call reminder.



Call Reminder Delay Set the interval between the declined call and the call reminder.• 5 minutes• 15 minutes• 30 minutes• 1 hour• 3 hours• Tomorrow

CUSTOM COLORS

Select Your Colors Change the color for various parts of the screen and tap Apply Colors. Tap Reset Colors to easily return to the default settings.

MESSAGING

Enable IM and Presence This is a premium feature. See “Presence and Messaging” on page 65.Appears when Presence and Messaging has been purchased.• ON: Bria can be used for sending instant messages and sharing online status. To use

IM and Presence on a SIP account, Settings > Accounts (SIP) > Account Specific Features > Enable IM and Presence must be ON.

• OFF: You will not be able to use SIP or XMPP accounts for presence and messaging.

Enable SMS This is a premium feature. See “Presence and Messaging” on page 65.Appears when Presence and Messaging has been purchased.• ON: Bria can be used for sending SMS messages to PSTN numbers. To use SMS on a

SIP account, Settings > Accounts (SIP) > Account Specific Features > Enable SMS must be ON.

• OFF (default): You will not be able to use a SIP account for sending SMS.

Alert Sound • ON: Your Android device plays a ringtone when you receive a new message.• OFF: Your Android device does not play a ringtone when you receive a new message.

Alert Vibration • ON: Your Android device vibrates when you receive a new message.• OFF: Your Android device does not vibrate when you receive a new message.

Alert Text Tone Select the ringtone for incoming messages.

CALL IN PROGRESS

Auto Record Calls • ON: Bria automatically record all calls made with Bria.• OFF (default): Bria records a call only if you tap Start Recording during a call.

Play Music On Hold This setting controls music played locally by Bria. If your VoIP service provider has the ability to play music on the server side, turning this setting OFF will not turn off the music if it is being played by your VoIP service provider.• ON: Play classical music to party on hold. All the participants hear music if it is a

conference call. • OFF: Default

Use proximity sensor Turn this OFF only if you encounter difficulties on your device.• ON: Bria uses the proximity sensor for the device.

PHONE NUMBER

Single Touch to Call When IM, SMS and/or video are enabled, this setting is ignored. Bria displays a prompt to choose an option.• ON: When making a call from Contacts or History, the call is placed when you tap a

phone number.• OFF: When you tap the phone number, a prompt appears. Tap the prompt to place the

call.

Field Description



Show URI Domain ON: The phone number displayed for an incoming, outgoing, or established call includes the domain name (for example, [email protected]).OFF (default): The domain name is not displayed.

CLIENT-SIDE CALL FORWARDING

Forward Calls • When ON, Bria send all incoming calls to a specific number if Bria is enabled and registered. Settings > Preferences > Keep Wi-Fi Radio Awake must be ON as well.

To Number Appears when Settings > Preferences > Forward Calls in ON.Enter the number to forward calls to.

ADDITIONAL

Keep Wi-Fi Radio Awake Controls whether the Wi-Fi radio stays on when the screen goes black (phone gets auto locked).• ON (checked): Wi-Fi radio stays on. When the screen goes black: (1) you stay logged

on via Wi-Fi (if you are in your Wi-Fi network), and (2) incoming calls use Wi-Fi instead of mobile data. Radio On uses more battery power. Choose ON if you have a limited data plan.

• OFF: Wi-Fi radio is turned off. When the screen goes black: (1) Bria re-logs in via the mobile data network, and (2) incoming calls use your mobile data plan. If mobile data is not enabled on your phone and/or in Bria, Bria logs out and you will not receive calls as long as the phone is dark. Radio Off uses less battery power. Choose OFF if you have an unlimited data plan.

Auto Start on Boot • ON: Automatically start and log into Bria when you start your Android device. Even if Bria was logged out when you powered off the phone, Bria will start and log in when the phone starts.

Show All Contacts • ON: Bria will display all device contacts regardless of native contacts group membership.

Contact Sort Order Change your contact sort order preference.• First Name: Sorts contacts based on their first name.• Last Name: Sorts contacts based on their last name.

This setting becomes available/changeable when Bria cannot access the preferences on the Android OS. If this setting is read-only in Bria, go to the Android device settings (such as the Contacts app) and change the sort preference.

Contact Display Order Change your contact display preference in your Contacts and Buddies lists. • First Name First: Displays a contact name as “John Smith”. • Last Name First: Displays as “Smith, John”.

This setting becomes available/changeable when Bria cannot access the preferences on the Android OS. If this setting is read-only in Bria, go to the Android device settings (such as the Contacts app) and change the display preference.

Use Phonetic Sorting • ON: Sort contacts by phonetic names such as “Yomigana”/”Furigana” or “Pinyin”. Enabling this preference will slow contact loading.

• OFF: Default

When contact names include Japanese or Chinese characters and the names do not appear correctly on Bria, enabling this preference may solve the problem.

Use LED Notifications • ON: Turns on the pulse notification light on supported devices. When Bria has a new IM/SMS or a missed call, the notification light will blink.

• OFF: Does not turn on the pulse notification light.

Field Description



VIDEO CALLS

Enable Video You must purchase the Video Calls premium feature to make and receive video calls. (See “Purchase a Premium Feature” on page 111.)Appears when Video Calls has been purchased.• ON: Bria can be used for video calls. To place Video Calls, Settings > Accounts (SIP)

> Account Specific Features > Enable Video must be ON.• OFF: You will not be able to make and receive video calls on Bria.

Send Landscape Appears when Settings > Preferences > Enable Video is ON.• ON: Video will be forcibly sent in the landscape orientation. This is a compatibility

mode for older devices that cannot render video in the portrait orientation. Turn on only when it is necessary.

• OFF: Default

Video Quality Appears when Settings > Preferences > Enable Video is ON.Choose video quality for video calls.• Automatic (Recommended): Bria selects the best quality to use in a given situation.• Low (QCIF): Quarter Common Intermediate Format uses 176 horizontal pixels and

144 vertical lines. QCIF transfers one-fourth the amount of data and consumes less memory the CIF.

• Standard (CIF)• High (VGA)• HD (720p VP9 only)

Field Description



8.3 Advanced SettingsNOTE: When you change an Advanced Settings, you may be prompted to apply the changes. In order to apply the changes, Bria automatically unregisters and re-registers all enabled accounts. This may take a few seconds.

Field Description

MEDIA OPTIONS

Voice Activity Detection • ON: Audio is not transmitted when no one talking. Turning this feature ON may reduce bandwidth usage. In some cases, the use of Voice Activity Detection can cause unnatural silence.

• OFF (default): Audio is transmitted when there is no one talking.

Quality Of Service Ask your VoIP service provider if quality of service (QoS) is supported. QoS can allow your calls to be given a higher priority on the network. Turing QoS ON has no effect if your VoIP service provider does not support it.• ON: Each voice data packet is marked, allowing a VoIP aware router to prioritize

them to help increase audio quality.• OFF: Default

QoS SIP Value Appears when Settings > Advanced Settings > Quality of Service is ON.Quality of Service for SIP includes TCP, TLS, and RTP.

QoS Audio Value Appears when Settings > Advanced Settings > Quality of Service is ON.Quality of Service is for RTP only.

QoS Video Value Appears when Settings > Advanced Settings > Quality of Service is ON.Quality of Service is for RTP only.

SIP Port StartSip Port End

Set a SIP Port Start and SIP Port End for SIP signaling.The value 0 implies default/automatic. The appropriate setting depends on your device setup. If your device is behind a restrictive firewall that only allows specific port ranges to be used, enter the SIP Port Start and SIP Port End to use for your SIP account.Note: You must also open those ports on your firewall. Refer to the applicable firewall documentation.

RTP Port Audio StartRTP Port Audio End

Set an RTP Port Audio Start and RTP Port Audio End for RTP audio.The value 0 implies default/automatic. The appropriate setting depends on your device setup. If your device is behind a restrictive firewall that only allows specific port ranges to be used, enter the range of ports to use for your RTP account.Note: You must also open those ports on your firewall. Refer to the applicable firewall documentation.

RTP Port Video StartRTP Port Video End

Set an RTP Port Video Start and RTP Port Video End for RTP video.The value 0 implies default/automatic. The appropriate setting depends on your device setup. If your device is behind a restrictive firewall that only allows specific port ranges to be used, enter the range of ports to use for your RTP account.Note: You must also open those ports on your firewall. Refer to the applicable firewall documentation.

ADVANCED MEDIA OPTIONS

Use Audio Track Allows you to change the audio API type for playback. If you experience poor audio, try changing this setting.

Echo Cancellation • ON (default): If you or the remote party is experiencing echo, this can help eliminate the echo.

• OFF: Echo cancellation is not used.

If you or the remote party still experience echo, turn this setting OFF.



Use Software AEC Appears when Settings > Advanced Settings > Echo Cancellation is ON.• ON: Enables software audio echo cancellation on Bria.• OFF:Disables software audio echo cancellation on Bria.

Turn this setting ON only if you encounter issues with echo and your device does not have hardware support for echo cancellation. CounterPath recommends using hardware support if it is available.

Noise Suppression • ON (default): Bria attempts to reduce background noise from your microphone.• OFF: Bria does not attempt to reduce background noise.

Use Software NS Appears when Settings > Advanced Settings > Noise Suppression in ON.• ON: Enables software noise suppression on Bria.• OFF: Does not enable software noise suppression on Bria.

Turn this setting ON only if you encounter issues with background noise and your device does not have hardware support for noise suppression. CounterPath recommends using hardware support if it is available.

Audio Gain Control • ON: Bria automatically adjusts the audio gain.• OFF: Bria does not automatically adjust the audio gain.

Configure Microphone Level Appears only when Settings > Advanced Settings > Audio Gain Control is ON.Tap on Configure Microphone Level and adjust the slider to adjust microphone gain.

AUDIO CODECS SELECTION

Mobile Audio Codecs CounterPath recommends using the default settings. See “Wi-Fi and Mobile Audio Codecs” on page 108.

Wi-Fi Audio Codecs CounterPath recommends using the default settings. See “Wi-Fi and Mobile Audio Codecs” on page 108.

VIDEO CODECS SELECTION

Video Codecs • H264 - offers 720p HD support.• VP8

Hardware Encoder Turn this setting ON if hardware encoding is available and has proven beneficial.• ON: Hardware support is used to encode video.• OFF: Default.

To see if your device is using hardware encoding, look at the Call Statistics during a video call when Hardware Encoder is ON. If the Video > Decoder value is software, your device does not support hardware encoding.

Hardware Decoder • ON (default): Hardware support is used to decode video.• OFF: Hardware support is not used to decode video.

To see if your device is using hardware decoding, look at the Call Statistics during a video call when Hardware Decoder is ON. If the Video > Encoder value is software, your device does not support hardware encoding.

Field Description



CodecsCodecs are programs in Bria that encode and decode a digital data stream when transmitting audio and video. Each codec has different characteristics and each works better in some situations than others.

Novice and Non-technical Users

CounterPath recommends you use the default setting/priority and let Bria select the best codec to use in a given situation.

TLS CERT MANAGEMENT

Verify HTTPS TLS Cert Applies to HTTPS connections except for provisioning. • ON (default): Bria attempts to verify the certificates sent by the corresponding HTTPS

server are trusted.• OFF: Bria accepts the certificate without attempting to verify it.

If the certificate is trusted by a well-known certificate authority such as VeriSign, you do not need further action.If the certificate is a self-signed certificate, you need to install a corresponding CA certificate on your device in advance. Contact your VoIP service provider to get a corresponding CA certificate and save it to your device. Enter the CA certificate in Android Settings > Security > Credential Storage.The CA cert should appear under Android Settings > Security > Credential Storage > Trusted credentials.

ACCOUNT REGISTRATION ISSUES

Alert In Background • ON: Bria sends notifications when an account fails to register. Bria also notifies the user after the account is successfully re-registered. Make sure that Bria notifications are enabled under Android Settings > Notification > Bria.

• OFF (default): Bria does not send notifications regarding account registration errors.

DEVICE HARDWARE

Playback Stream This settings controls how the device processes the audio receiving from the remote party. If you are receiving poor audio, try changing the playback stream.

SIP MISCELLANEOUS

Encode # in URI • ON (default): Bria escapes a hash character (#) used in the user part of SIP URI, as required by RFC 3261.

• OFF: Bria does not escape a hash character (#) and sends it as is. Turn this setting OFF if you are having trouble making outgoing calls to a number with a hash character.

APPLICATION LOGGING

Verbose Logging Leave this OFF unless Technical Support instructs you to turn it ON to troubleshoot a problem you are having on your device. See "Appendix A: Troubleshooting" on page 113.

Send Log Tap to upload the current log to Technical Support. See "Appendix A: Troubleshooting" on page 113.

CALL STATISTICS

Call Statistics Shows detailed information about the current/last call, such as the number of packets lost.For an ongoing call, the statistics information refreshes every second. • Tap Refresh to stop auto-refresh and present a snapshot of the most current statistics. • To enable auto-refresh again, either long press Refresh, or leave the statistics page and

come back again.

Field Description



Technically Savvy Users

You may choose to enable one, some, or all codecs. If only one codec is enabled, all calls will be made with that codec. If more than one is enabled, Bria negotiates the codec to use (from among the enabled codecs) with the other SIP client. In general, it is desirable to have several codecs enabled. If no codecs are enabled, Bria uses G.711µLaw.

Make sure that there are common codecs between you and the remote peer. If you do not have a common codec, the audio call will fail with a 488 error or video will not be available on the call.

Prioritize codecs by pressing and holding the icon and dragging the codecs up or down in the list. Codecs higher in the list are given a higher priority in the offer when negotiating codecs with the remote party. Moving a codec higher should improve its chances of being chosen.

If you would like to set the codecs back to the default settings, tap the More icon and tap Reset to Defaults. Tap Yes on Reset to Defaults.

Wi-Fi and Mobile Audio CodecsAMR-WB and G.729 Codecs are premium features (see “Purchase a Premium Feature” on page 111).

SILK-SWB (24k) and OPUS (Fullband-48k) are only available in devices with 1.2 G Hz dual core CPU or higher. These codecs will be disabled on any slower devices.

Bria offers Opus, SILK-NB, SILK-WB, SILK-SWB, G.729, AMR - WB, G.722, G.711µLaw, G.711ALaw, GSM, Speex-NB and Speex-WB codecs.



Narrow and Wideband

AMR-WB, G.722-WB, SILK-WB(16k), SILK-SWB(24k), Opus (Full HD-48kHz), and Speex-WB are wideband codecs. All other codecs are narrowband. When a wideband codec is used, data usage is higher and audio quality is generally better. When a narrowband codec is used, data usage may be lower but audio quality may be affected.

Data Usage

G.722, G.711, GSM, and G.729 have a fixed bit rate. They are arranged from highest data usage to lowest data usage.

Speex-NB, Speex-WB, AMR-WB, SILK, and Opus have a variable bit rate; the data usage will fluctuate depending on the network conditions.• G.729 provides the best performance (audio quality and bandwidth usage/cost) when using mobile data for

phone calls.• G.711 is the most commonly used codec, but requires substantial bandwidth.• G.722 is a wideband (HD) codec providing excellent audio quality. However, your VoIP service provider

may not support G722 for PSTN calls (standard phone numbers). Enable G722 only if it can actually be used. If enabled, the clock rate is switched from 8kHz to 16 kHz. This can impact the audio quality when other codecs are used.

Video Codecs Selection

Available Codecs

H.264 and VP8 (with 720p HD video support) can be used during a video call over a Wi-Fi or a mobile network.



8.4 Premium FeaturesNOTE: If you plan to use your SIP account for presence and messaging, make sure your VoIP service provider supports SIP SIMPLE before you purchase the Presence and Messaging premium feature.

The following are premium features in Bria:

• Presence and Messaging• Video Calls• G.729a Codec and AMR-WB Codec

Presence and MessagingPresence and Messaging allows you to send instant messages (IMs) to your Buddies and share your online sta-tus (presence) with them. You can use this feature on XMPP accounts and/or SIP accounts, depending on whether your VoIP service provider supports this feature for SIP SIMPLE. With SIP accounts, you can also send SMS to PSTN cell phone numbers if your VoIP service provider supports this feature.

After the purchase, you need to set up your account. See “Set Up Bria for Presence and Messaging” on page 9 to set up this feature.

Video CallsWith this feature, you can make video calls to softphone numbers over a Wi-Fi or a mobile data network. The codecs H.264 and VP8 are supported. Make sure that your VoIP service provider supports video calls before the purchase. After purchasing, turn ON Settings > Preferences > Enable Video and Settings > Accounts (SIP) > Account Specific Features > Enable Video. Then you will see an option to make video calls on the Contacts tab and the History tab. See “Voice and Video Calls” on page 14.

AMR-WB and G.729 CodecsAMR-WB and G.729 codecs are premium features. Codecs are programs in Bria involved in transmitting audio or video. Each codec has different characteristics and works better in some situations than in others.

AMR-WB Audio CodecAdaptive Multi-Rate wideband (AMR-WB) audio codec is a wideband codec that provides superior sound qual-ity due to a wider speech bandwidth.

G.729 Audio CodecG.729 is a narrowband codec that is intended for low bandwidth use. It is particularly recommended if you will be making calls over mobile data network (3G/4G/LTE) because it provides better audio quality on your mobile data connection.



Purchase a Premium Feature1. Go to the Settings tab on the resource panel.

2. Tap Premium Features.

3. Tap the premium feature you want to purchase.

4. Tap on Continue to connect to the Google Play store.

5. Follow all instructions from Google Play.

The Premium Feature is now available in Bria.




8.5 ShareShare Bria with your friends via Twitter and email.

TwitterBria publishes a post on your Twitter page on your behalf with a link to Bria’s app page.

Make sure that you have the official Twitter app installed on your device and that you are logged in.

EmailMake sure your email account has been set up on your Android.


2. Tap About Bria.

3. Tap the Share icon.

4. Choose the email app you want to use to share Bria.

5. Add recipients and a Subject (optional) to the email and edit the message (optional).

6. Tap Send.

Your message is sent.


Appendix A: Troubleshooting

1.1 Using Bria DiagnosticsIf you have a problem with Bria, Technical Support may ask you to turn diagnostics on to capture information.


2. Go to Advanced Settings > Verbose Logging. If Verbose Logging is OFF, turn it to ON.

3. Reproduce the problem you were having.

4. Go to Advanced Settings again.

5. Tap Send Log and tap Yes on the Sending Log message.

6. Tap Share on the Sending Log Success message.



7. Tap Copy to clipboard on Share with. The log reference number is on your clipboard.

8. Report this reference number to the Support Team Member who was assisting you. If you are opening a new topic, it always helps with issue diagnosis when support has logfile to look at.The description of the problem could include the following:

• What you were doing when the problem occurred. • Your Android device device and model.• Any recent changes you have made to your setup of Bria. • Whether you were using your normal Wi-Fi connection or a different Wi-Fi connection.• Whether you normally have mobile data (3G/4G/LTE) enabled on your device and in Bria.

9. Turn OFF Verbose Logging when you are done.

1.2 More Information and Technical SupportPlease visit our Technical Support at https://support.counterpath.com/ to:

• Search the knowledge base or FAQ.• Read forum topics.• Ask a question.• Submit a ticket.


https://support.counterpath.com


Appendix B: Glossary

Bria call A call made using the Bria call as compared to a “native call.”Codec Codecs are programs in Bria that encode and decode a digital data stream when

transmitting audio and video. Each codec has different characteristics and each codec works better in some situations than in others.

DTMF Dual-tone multi frequency. DTMF is the system that is used in interactive voice-response menu systems such as the menu system for accessing voice mail messages. The DTMF system allows the user to interact with the menu by pressing keys on a dial pad or keyboard.

Home button The button at the bottom of the Android device or iPod touch.IM Instant Messaging. A technology that lets users send text messages for near

instantaneous delivery and display on each others’ devices.ICE Interactive Connectivity Establishment. A method for traversing a firewall.IP address A unique number that identifies a device. Devices on a network use the IP address to

communicate with each other. IVR Interactive Voice Response. IVRs use DTMF. Media The audio portion (and the video portion if any) of a call. Compare to “Signaling.”Native call A call made using the phone service that comes with the Android device. Does not

apply to the iPod touch.Native phone service The phone service that comes with the Android device.PSTN Public Switch Telephone Network. The traditional land-line phone network.Presence An instant messaging feature that allows users to share information about their online

status.Signaling The information in a call that deals with establishing and controlling the connection,

and managing the network. The non-signaling portion of the call is the Media.SIP Session Initiation Protocol. The signaling protocol followed by Bria for handling

phone calls. SIP account An account that provides the user with the ability to make VoIP phone calls. The

account encapsulates the rules and functions the user can access.softphone address The address used to connect to a SIP endpoint. In other words, the “phone number”

used in a VoIP phone call. For example, sip:[email protected] Simple Traversal of UDP through a firewall or NAT.TURN Traversal Using Relays around NAT. Like STUN, it is a network protocol/packet

format (IETF RFC 5766) used to assist in the discovery of paths between peers on the Internet. It differs from STUN in that is uses a public intermediary relay to relay packets between peers.

Wi-Fi call A Bria call made over the Wi-Fi Internet. To make a Wi-Fi call, you must be in a Wi-Fi zone.



XMPP account An account that provides the user with the ability to send IMs and view other people’s presence.

3G/4G call A Bria call that uses the mobile data network rather than the Wi-Fi network. If you start (or receive) a call with an Android device when you are not in a Wi-Fi zone, the call will be a 3G/4G call. Not all supported devices support mobile data.


bria android edition user guide - counterpath · counterpath corporation about bria android edition...

Documents