Bria iPhone Edition User Guide

Bria iPhone Edition User Guide
Bria iPhone Edition User Guide
CounterPath Corporation
Bria iPhone Edition User Guide
CounterPath Corporation
Suite 300, One Bentall Centre
505 Burrard Street, Box 95
Vancouver, BC V7X 1M3
Canada
Telephone + 1.604.320.3344
sales@counterpath.com
www.counterpath.com
Copyright © 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 iPhone 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.
Stretto Platform and Stretto are trademarks of CounterPath Corporation.
All other products and services are the registered trademarks of their respective holders.
This guide corresponds to Bria iPhone Edition version 3.9
Rev 2
March 2017
Contents
About Bria iPhone Edition
1
Standard Telephone Features.....................................................................................................1
Advanced Features.....................................................................................................................1
Operating System Requirements ...............................................................................................2
Supported Accessories ...............................................................................................................2
Using Bria’s Interface ................................................................................................................2
Configuring
3
Launch and Close.......................................................................................................................3
Initial Setup................................................................................................................................3
Set Up Bria for Voice and Video Calls......................................................................................4
Set Up a SIP Account ..........................................................................................................4
Set Up Multiple SIP Accounts.............................................................................................4
Set Your Primary SIP Account ............................................................................................5
Delete a SIP Account ...........................................................................................................5
Set Up Bria for Presence and Messaging...................................................................................5
Set Up a SIP Account ..........................................................................................................6
Set Up an XMPP..................................................................................................................6
Delete a SIP or XMPP Account...........................................................................................7
Account Status ...........................................................................................................................8
Configure Dial Plans (Number Prefixes)...................................................................................8
Design a Dial Plan ...............................................................................................................8
Set Up a Dial Plan................................................................................................................9
Reorder a Dial Plan............................................................................................................10
Voice and Video Calls
11
Place a Voice Call....................................................................................................................11
Using the Dialpad ..............................................................................................................11
Using Bria’s Contacts ........................................................................................................11
Using Siri ...........................................................................................................................12
Handle Incoming Calls ............................................................................................................12
Bria is in the Foreground or Background ..........................................................................13
When the Device is Locked ...............................................................................................14
When You Are on Another Call ........................................................................................14
Place a Video Call....................................................................................................................15
Using Bria’s Contact List ..................................................................................................15
Using Siri ...........................................................................................................................16
Adding Video During an Audio Call .................................................................................16
Receiving a Video Call ......................................................................................................17
During a Video Call ...........................................................................................................18
Advanced Calling Options
20
Return to an Active Call ..........................................................................................................20
Bria in the Foreground or Background ..............................................................................20
Change the Audio Output ........................................................................................................20
Place a Second Call..................................................................................................................21
Using the Dialpad ..............................................................................................................21
i
CounterPath Corporation
Using Bria’s Contacts ........................................................................................................22
Swap Between Calls ................................................................................................................23
Conference Calls......................................................................................................................24
Transfer a Call .........................................................................................................................24
Attended Transfer Using the Dialpad ................................................................................25
Attended Transfer Using Bria’s Contacts ..........................................................................26
Unattended (Blind) Transfer Using the Dialpad................................................................27
Unattended (Blind) Transfer Using Contacts ....................................................................28
Call Recording .........................................................................................................................29
Record a Call .....................................................................................................................29
Listen to or Delete a Recording .........................................................................................30
Share a Recording ..............................................................................................................31
Voice Mail ...............................................................................................................................32
Access Voice Mail .............................................................................................................33
Change SIP Accounts ..............................................................................................................33
Using the Dialpad ..............................................................................................................34
Using Bria’s Contacts ........................................................................................................34
Pause Dialing for Auto Attendant............................................................................................35
Call History
37
Bria Call History ......................................................................................................................37
Call Type Icons ..................................................................................................................37
View Call Information .......................................................................................................37
Delete a Call.......................................................................................................................38
Delete All Calls..................................................................................................................38
Create a New Contact ........................................................................................................39
Add to an Existing Contact ................................................................................................39
Native Call History ..................................................................................................................40
Contacts
41
Add a Contact ..........................................................................................................................41
Edit a Contact...........................................................................................................................41
Delete a Contact.......................................................................................................................42
XMPP vCard “preferred” Property..........................................................................................42
Favorites...................................................................................................................................43
Add a Favorite ...................................................................................................................43
Delete a Favorite ................................................................................................................43
Fields that Must be Updated in iOS.........................................................................................43
Presence and Messaging
45
Presence ...................................................................................................................................45
Change Your Status ...........................................................................................................46
Create a Custom Status ......................................................................................................46
Delete a Custom Status ......................................................................................................47
Buddies ....................................................................................................................................47
Add a Buddy ...........................................................................................................................48
SIP SIMPLE - Create a New Buddy..................................................................................48
Bria iPhone Edition User Guide version 3.9
ii
CounterPath Corporation
SIP SIMPLE - Add an Existing Contact as a Buddy .........................................................49
XMPP - Add a Buddy ........................................................................................................50
Delete a Buddy.........................................................................................................................51
Buddy Requests .......................................................................................................................51
Send an XMPP Buddy Request .........................................................................................52
Respond to XMPP Buddy Request ....................................................................................52
Stop Sending Presence.......................................................................................................53
Send an IM...............................................................................................................................54
Using Messages - SIP and XMPP......................................................................................54
Using Contacts - SIP and XMPP .......................................................................................55
Using Siri - SIP and XMPP ...............................................................................................56
View and Reply to an IM.........................................................................................................56
When Bria is in the Foreground.........................................................................................56
When Bria is in the Background........................................................................................57
When the iPhone is Locked ...............................................................................................58
Pre-Defined Canned Messages ..........................................................................................58
Send an SMS............................................................................................................................59
Using Messages .................................................................................................................59
Using Contacts ...................................................................................................................60
XMPP Group Chat...................................................................................................................61
How XMPP Group Chat Works ........................................................................................61
Create a Group Chat ..........................................................................................................62
Add a Participant to a Chat ................................................................................................63
Join a Group Chat ..............................................................................................................64
Leave a Group Chat ...........................................................................................................64
Work with Message History ....................................................................................................65
Resend a Message ..............................................................................................................65
Copy or Delete Messages ..................................................................................................65
Forward Messages .............................................................................................................66
Use Emoticons/Emoji ........................................................................................................68
Settings
69
Accounts ..................................................................................................................................69
Accounts (SIP) ...................................................................................................................70
Dial Plan (Number Prefixes)..............................................................................................70
Account Specific Features (SIP)........................................................................................70
Account Advanced (SIP) ...................................................................................................72
Accounts (XMPP)..............................................................................................................75
Account Specific Features (XMPP)...................................................................................75
Account Advanced (XMPP) ..............................................................................................75
Network Traversal .............................................................................................................76
Custom DNS Servers .........................................................................................................78
Preferences...............................................................................................................................79
Advanced Settings ...................................................................................................................83
Codecs................................................................................................................................84
Premium Features ...................................................................................................................86
Bria iPhone Edition User Guide version 3.9
iii
CounterPath Corporation
Purchase a Premium Feature..............................................................................................86
AMR-WB and G.729 Codecs ............................................................................................86
Presence and Messaging ....................................................................................................87
Video Calls ........................................................................................................................87
Share ........................................................................................................................................88
Twitter................................................................................................................................88
Email ..................................................................................................................................88
Troubleshooting .............................................................................................................................90
Using Bria Diagnostics ............................................................................................................90
More Information and Technical Support ...............................................................................91
Native Integration ..........................................................................................................................92
Interaction between Bria and Native Phone ............................................................................92
Native Integration On ........................................................................................................92
Native Integration Off........................................................................................................93
Handling Calls with Native Integration Off ............................................................................93
Bria is in the Foreground ...................................................................................................94
Bria is in the Background ..................................................................................................94
Device is Locked ...............................................................................................................96
CarPlay and Bluetooth .................................................................................................................101
Using CarPlay ........................................................................................................................101
What You Need ...............................................................................................................101
What You Can Do: ..........................................................................................................101
When Native Integration is Disabled...............................................................................101
Using Bluetooth to Connect to a Car .....................................................................................102
Using Bluetooth Headsets......................................................................................................102
Glossary .......................................................................................................................................103
Bria iPhone Edition User Guide version 3.9
iv
CounterPath Corporation
About Bria iPhone Edition
1 About Bria iPhone Edition
Bria iPhone Edition is a SIP-based phone for the Apple iPhone. With Bria, you can use a Wi-Fi Internet connection on an iPhone 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 with an iPhone (but not with an iPod touch).
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. You must have a SIP SIMPLE or 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, 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.
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.
Siri support for calls and messages.
Bria iPhone Edition User Guide version 3.9
1
CounterPath Corporation
About Bria iPhone Edition
1.3 Operating System Requirements
Bria runs on iOS 9.0 and later.
1.4 Supported Accessories
•
•
Headset with microphone (including Bluetooth™): Bria uses the earpiece and microphone on the headset.
Headphones (no microphone): Bria uses the earpiece on the headphone and the built-in microphone on the
device.
1.5 Using Bria’s Interface
Tap to select dial-out account (appears only if
more than one SIP account is enabled).
Account status and primary
SIP account.
Dial Pad
Navigation Panel
Navigation Tabs
Bria iPhone Edition User Guide version 3.9
2
CounterPath Corporation
Configuring
2 Configuring
2.1 Launch and Close
Tap the Bria
Bria”.
icon to launch Bria or press and hold the Home button on your iPhone and ask Siri to “Launch
Tap the iPhone’s home button twice and swipe up on Bria in the preview screen to close Bria.
2.2 Initial Setup
NOTE: 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 iOS 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 iOS settings > Cellular and turn ON Cellular Data.
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 iPhone.
6. 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.
7. When prompted, give Bria permission to access your microphone and contacts, and allow Bria to send
notifications on the iPhone. Without the permissions, Bria’s Contacts tab will be empty and Bria calls will
have no audio.
Bria iPhone Edition User Guide version 3.9
3
CounterPath Corporation
Configuring
2.3 Set Up Bria for Voice and Video Calls
To use Bria for voice and video calls, you need to create a SIP account. You need to get your username,
password and domain from you VoIP service provider. If you have voice mail with your service provider, get
your voice mail number. If your VoIP service provider uses an authorization name, get it from your service
provider as well.
Set Up a SIP Account
1. 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 VoIP (SIP) – Calling.
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 Auth Name field. (Tap < New
SIP Account to return to the New SIP Account screen.)
5. Tap Enable.
6. Tap Save.
Your SIP account is set up. Bria displays the SIP account in Settings > Accounts.
Set Up Multiple SIP Accounts
You 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.
Bria iPhone Edition User Guide version 3.9
4
CounterPath Corporation
Configuring
Set Your Primary SIP Account
When you have more than one SIP account, one SIP account is 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 and tap the account you want to set as your primary account.
Your primary account has a green arrow beside it in Settings > Accounts.
Delete a SIP Account
SIP accounts are deleted using the standard Apple action for revealing the Delete button.
1. Go to Settings > Accounts.
2. Swipe the account to be deleted to the left.
3. Tap the Delete button.
Bria deletes the account and no longer displays it in Settings > Accounts.
2.4 Set Up Bria for Presence and Messaging
NOTE: 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 86. 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. Texting
(sending SMS) to PSTN mobile phone numbers is also available 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
Messages tab appears at the bottom of Bria. If the Messages does not appear, turn ON Settings > Preferences >
Enable IM & Presence once you have set up your SIP or XMPP account.
Follow the steps below, depending on the protocol you want to use.
Bria iPhone Edition User Guide version 3.9
5
CounterPath Corporation
Configuring
Set Up a SIP Account
Make sure your VoIP service provider supports SIP SIMPLE for voice and video calls first. If you have not
created your SIP account, see “Set Up a SIP Account” on page 4.
1. Go to Settings > Preferences.
2. Turn ON Enable IM & Presence and Enable SMS (if applicable).
3. Go to Settings > Accounts and tap
beside your SIP account.
4. Tap Unregister.
5. Tap Account Specific Features.
6. Turn ON Enable IM & Presence and Enable SMS (if applicable).
7. Tap < SIP Account.
8. Tap Register.
The Messages tab appears in the navigation 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 48.
Set Up an XMPP
You need your XMPP account Username, Password and Domain to set up your XMPP account.
1. Go to Settings > Preferences.
2. Turn ON Enable IM & Presence.
3. Go to Settings > Accounts and tap +.
4. Tap XMPP - Messaging.
5. Complete Account Name, Username, Password, and Domain with the information provided by your XMPP
Provider.
6. Turn ON Enable.
7. Tap Save.
Bria iPhone Edition User Guide version 3.9
6
CounterPath Corporation
Configuring
The Messages tab appears in the navigation panel and Bria displays the XMPP account in Settings > Accounts.
The account is ready to be used 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 Account
SIP and XMPP accounts are deleted using the standard Apple action for revealing the Delete button.
1. Go to Settings > Accounts.
2. Swipe the account to be deleted to the left.
3. Tap the Delete button.
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.
Bria iPhone Edition User Guide version 3.9
7
CounterPath Corporation
Configuring
2.5 Account Status
Status
Account Type
Means that...
SIP
The account can be used to make and receive phone calls.
SIP
The account can only be used to make phone calls.
SIP
The account is disabled. Open the account and turn ON Enabled.
SIP
The account is enabled, but it is not registered. Open the account and tap Register.
If you do not want to use an account, turn OFF Enabled rather than unregistering it. If you leave
the account unregistered (instead of disabled), it automatically registers the next time you start
Bria.
SIP
The primary account. This account will be used for outgoing calls unless you select a different
account when placing a particular call.
XMPP
The account is connected to an XMPP server and can be used for Presence and Messaging.
XMPP
The account is disabled. Open the account and turn ON Enabled.
XMPP
The account is enabled but it is not connected. Open the account and tap Connect.
If you do not want to use an account, turn OFF Enabled than disconnecting it. If you leave the
account disconnected (instead of disabled) it automatically connects the next time you start Bria.
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. Dials plans can be reordered after they have been
created.
Design a Dial Plan
A 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
• add a prefix, or
• remove one prefix and add another one.
Subsequence substitution is also supported.
Bria iPhone Edition User Guide version 3.9
8
CounterPath Corporation
Configuring
Set Up a Dial Plan
1. Go to Settings > Accounts and tap
beside 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 dialpad 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.
Advanced: Subsequence Substitution
Using the format <A:B>, Bria matches string A and replaces it with string B. For example, A=+1 and B=011.
<+1:011> matches +16041122233 and modifies it to 0116041122233.
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 1
Match number: +1613x.
Remove Prefix: +1613
Add Prefix: 9
If the input starts with “+1613”, then remove the “+1613” then add “9” and dial the number. So +16135550012
is dialed as 95550012.
Example 2
Match number: [2-9]xxxxxxxxx
Bria iPhone Edition User Guide version 3.9
Add Prefix: 1
9
CounterPath Corporation
Configuring
If the input is a 10-digit number starting with a number other than 1, then add “1” and dial the number. So
6045550012 is dialed as 16045550012.
Reorder a Dial Plan
Dial plans are applied in the order that they appear. You do not have to create them in order. You can reorder the
dial plans.
1. Go to Settings > Accounts and tap
beside the SIP account with the dial plans you want to reorder.
2. Tap Dial Plan (Number Prefixes).
3. Tap and hold
and drag it up or down until it is in the desired order.
4. Repeat with all dial plans.
The dial plans are listed in the correct order
Bria iPhone Edition User Guide version 3.9
10
CounterPath Corporation
Voice and Video Calls
3 Voice and Video Calls
3.1 Place a Voice Call
Using the Dialpad
1. Go to the Phone tab on the navigation panel.
2. Enter the number you want to dial. Tap the X to clear the entry or tap in the entry field to bring up the
keyboard. Tap return to close the keyboard.
3. Tap
.
Bria completes the call.
Using Bria’s Contacts
1. Go to the Contacts tab on the navigation panel.
Bria iPhone Edition User Guide version 3.9
11
CounterPath Corporation
Voice and Video Calls
2. Select the contact by tapping on the contact or typing their name in the search bar and tapping on the
contact.
3. Tap the number you want to dial. If Enable Video is OFF and Single Touch to Dial is ON, Bria dials the call
immediately. If not, go to step 4.
4. Tap the Call prompt.
Bria starts the call.
Using Siri
You can use Siri to place a voice call when Bria is in the foreground, background, exited or when your iPhone is
locked. The first time you use Siri, you must give Siri permission to access Bria’s data. To phone a person using
their name, the person must be in Bria’s contacts.
1. Press and hold the Home button on your iPhone.
2. Ask Siri to “Call Joseph Santos with Bria” or “Call 6045551234 with Bria”.
Bria starts the call.
3.2 Handle Incoming Calls
All methods for handling incoming calls assume that Settings > Preferences > Native Integration is ON. For
information on how Bria interacts with the native dialer and how to handle a call if Native Integration is OFF,
see Appendix B: Native Integration on page 92.
Bria iPhone Edition User Guide version 3.9
12
CounterPath Corporation
Voice and Video Calls
Bria is in the Foreground or Background
When Bria is in the foreground or the background, Bria displays the name of the remote party and presents the
Decline and Accept options.
1. Tap Decline or Accept.
Bria declines or starts the call. Bria’s advanced calling options are available when you accept the call (see
page 20).
Bria iPhone Edition User Guide version 3.9
13
CounterPath Corporation
Voice and Video Calls
When the Device is Locked
When the iPhone is locked, you receive an incoming call notification similar to an incoming native call on the
lockscreen.
1. Slide the phone icon to the right to answer the call. Tap the iPhone power button or the volume buttons to
silence the incoming ringtone without answering the call.
Bria starts the call. To use Bria’s advanced calling options (see page 20), tap the Bria icon and enter the passcode for the iPhone.
When You Are on Another Call
You have three options when you receive an incoming call when you are already on a call. Bria presents you
with the options:
End & Accept: Bria ends the first call and answers the incoming call.
Decline: Bria continues with the first call and ends the incoming call.
Hold & Accept: Bria puts the first call on hold and answers the incoming call.
Bria iPhone Edition User Guide version 3.9
14
CounterPath Corporation
Voice and Video Calls
Network Quality
The Network Quality Indicator on the call panel displays the current network conditions.
Indicator
Icon
Good
Fair
Poor
Unknown
Wi-Fi Networks
If the Network Quality Indicator shows “Poor”, this indicates there is network congestion or a poor quality WiFi signal. Try moving closer to your Wi-Fi access point.
Mobile Networks
If 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.
3.3 Place a Video Call
To use video calling on Bria, purchase the Video Calls premium feature (see page 86).
Using Bria’s Contact List
1. Go to the Contacts tab on the navigation panel.
2.
Bria iPhone Edition User Guide version 3.9
15
CounterPath Corporation
Voice and Video Calls
3. Select the contact by tapping on the contact or typing their name in the search bar and tapping on the
contact.
4. Tap the number you want to call.
5. Tap the Video prompt.
Bria starts sending your video as soon as the other party accepts your video call.
Using Siri
You can use Siri to place a video call when Bria is in the foreground, background, exited or the iPhone is
locked. The first time you use Siri, you must give permission for Siri to access Bria’s data. To video call a person using their name, the person must be in Bria’s contacts.
1. Press and hold the Home button on your iPhone.
2. Ask Siri to “Video call Joseph Santos with Bria” or “Video call 6045551234 with Bria”.
Bria starts the video call.
Adding Video During an Audio Call
When you place a call using the dialpad, Bria makes an audio call. You can add video to the audio call.
1. Swipe left on the screen.
Bria iPhone Edition User Guide version 3.9
16
CounterPath Corporation
Voice and Video Calls
OR
1. Tap More.
2. Tap Start Video.
Bria starts initializing video. You see the remote party’s video after they add video on their end.
Receiving a Video Call
When the remote party places a video call, you see their video on Bria when you answer the call. You can send
video back or turn off their video.
Sending Your Video
1. Tap the Send icon to start sending your video.
Bria iPhone Edition User Guide version 3.9
17
CounterPath Corporation
Voice and Video Calls
Stop Sending Your Video
2. Swipe right on the screen.Tap More.
3. Tap Stop Video.
Bria switches the call to an audio call.
During a Video Call
During 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 24.
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 21 or see “Conference Calls” on page 24.)
Record the audio portion of a video call See “Call Recording” on page 29.
Mute a video call by tapping Mute or by swiping to the right and tapping Mute.
Swipe right and tap Mute.
Bria iPhone Edition User Guide version 3.9
18
CounterPath Corporation
•
Voice and Video Calls
Hide the Local Video Preview bytapping Preview.
Image Preview
Bria iPhone Edition User Guide version 3.9
19
CounterPath Corporation
Advanced Calling Options
4 Advanced Calling Options
With Bria’s advanced calling options, you can:
• Return to an active call (page 20).
• Change the audio output (page 20).
• Place a second call (page 21).
• Merge and split two calls (page 24).
• Transfer a call (page 24).
• Record a call (page 29).
4.1 Return to an Active Call
Bria in the Foreground or Background
While on a call, you can navigate away from the call screen to any of the tabs in the navigation panel or you can
put Bria in the background.
Tap the arrow in the top left corner to navigate away from the call within Bria. Tap the iPhone home button to
put Bria in the background.
Tap the green banner at the top of the screen to return to the call.
4.2 Change the Audio Output
Bria can play audio through the iPhone, over the speaker phone, or through supported accessories (see “Supported Accessories” on page 2).
When a Bluetooth device is connected and Settings > Preferences > Native Integration is ON, answering the
call by tapping on the iPhone plays the audio through the iPhone. Answering the call by tapping a button on
your Bluetooth device plays the audio through the Bluetooth device.
Bria iPhone Edition User Guide version 3.9
20
CounterPath Corporation
Advanced Calling Options
To turn ON speaker phone, quickly tap the Speaker or Audio icon. The speaker button displays the Bluetooth
icon if there are Bluetooth devices paired with the iOS device.
To chose a different audio output option, long tap the Speaker or Audio icon and select your preferred audio
output.
4.3 Place a Second Call
Using the Dialpad
When you have one call established, you can place that call on hold and make a second call.
1. Tap Hide Keypad if the Keypad is displayed.
2. Tap Hold to put the first call on hold.
3. Tap Add Call.
Bria iPhone Edition User Guide version 3.9
21
CounterPath Corporation
Advanced Calling Options
4. If necessary, tap the Phone tab on the navigation panel to display the Dialpad.
5. Dial the number of the person of the second party you want to call and tap
.
Bria connects the second call. If you end one of the calls, Bria automatically switches back to the other call.
Using Bria’s Contacts
1. Tap Hide Keypad if the Keypad is displayed.
2. Tap Hold to put the first call on hold.
3. Tap Add Call.
4. If necessary, go to the Contacts tab on the navigation panel to display Bria’s contacts.
5. Select the contact by tapping on the contact or typing their name in the search bar and tapping on the
contact.
Bria iPhone Edition User Guide version 3.9
22
CounterPath Corporation
Advanced Calling Options
6. Tap the number you want to dial.
7. Tap the Call prompt.
Bria connects the call. If you end one of the calls, Bria automatically switches back to the other call.
4.4 Swap Between Calls
Once you have established a second call (see “Place a Second Call” on page 21), you can swap between both
calls.
1. Tap Swap Calls.
Bria iPhone Edition User Guide version 3.9
23
CounterPath Corporation
Advanced Calling Options
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 Calls
When you have two calls established (see page 21), you can merge the two calls into a three way conference call
and you can split them back to two separate calls.
1. Tap Merge to merge the two established calls. Bria displays Conference.
2. Tap Split to split the two calls. Bria displays the name of the remote party for the active call.
Bria merges or splits the calls. If you have two calls merged and you end the call, both calls are ended. The
remote parties cannot continue the call without you.
4.6 Transfer a Call
Calls can be transferred to a second party in two ways. In an attended transfer, the first party speaks to the second 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.
Bria iPhone Edition User Guide version 3.9
24
CounterPath Corporation
Advanced Calling Options
Attended Transfer Using the Dialpad
1. Tap Hold to put the first call on hold.
2. Tap Add Call.
3. Go to the Phone tab on the navigation panel to display the Dialpad if necessary.
4. Enter the number of the person you want to transfer the call to and tap
.
5. When you have finished speaking to the party you are transferring the call to, tap More.
6. Tap the Transfer to prompt.
Bria connects the second party to the remote party. Bria disconnects you from the both calls.
Bria iPhone Edition User Guide version 3.9
25
CounterPath Corporation
Advanced Calling Options
Attended Transfer Using Bria’s Contacts
1. Tap Hold to put the first call on hold.
2. Tap Add Call.
3. Go to the Contacts tab on the navigation panel to display Bria’s Contacts.
4. Select the contact by tapping on the contact or typing their name in the search bar and tapping on the
contact.
5. Tap the number you want to dial.
Bria iPhone Edition User Guide version 3.9
26
CounterPath Corporation
Advanced Calling Options
6. Tap the Transfer to prompt.
Bria connects the remote party to the second party. Bria disconnects you from the both calls.
Unattended (Blind) Transfer Using the Dialpad
1. Tap More.
2. Tap Transfer from the popup menu.
3. If necessary, go to the Phone tab on the navigation panel to display the Dialpad.
4. Enter the number you want to transfer the call to.
5. Tap
.
Bria puts the remote party on hold while dialing the second party. Once the call connects, Bria ends the call
between you and the remote party. If the second party answers the call, the call continues between the second
party and the remote party. If the second party declines the call, the call ends.
Bria iPhone Edition User Guide version 3.9
27
CounterPath Corporation
Advanced Calling Options
Unattended (Blind) Transfer Using Contacts
1. Tap More.
2. Tap Transfer from the popup menu.
3. Go to the Contacts tab on the navigation panel to display Bria’s Contacts.
4. Select the contact by tapping on the contact or typing their name in the search bar and tapping on the
contact.
5. Tap the number you want to dial.
Bria iPhone Edition User Guide version 3.9
28
CounterPath Corporation
Advanced Calling Options
6. Tap the Transfer to prompt.
Bria puts the remote party on hold while dialing the second party. Once the call connects, Bria ends the call
between the first party and the remote party. If the second party answers the call, the call continues between the
second party and the remote party. If the second party declines the call, the call ends.
4.7 Call Recording
Record a Call
When you record a call, Bria plays a call recording tone to the remote party when the recording starts.
• Muting a call does not silence the tone.
• If a call is put on hold (either by yourself or the other party), the recording is paused. Bria plays the call
recording tone to the remote party when the call resumes.
When you transfer a call, Bria stops recording the call when you are redirecting the call. Bria plays the call
recording tone to the remote party when the recording resumes.
1. Tap More during an established call.
2. Tap Start Recording. Bria displays a small red, flashing icon to show that the call is being recorded.
Bria iPhone Edition User Guide version 3.9
29
CounterPath Corporation
Advanced Calling Options
3. Tap More to end the recording.
4. Tap Stop Recording.
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.
Listen to or Delete a Recording
1. Go to the History tab on the navigation panel.
2. Tap
beside the call with the call recording indicator.
3. Tap Listen to Call Recording.
Bria iPhone Edition User Guide version 3.9
30
CounterPath Corporation
Advanced Calling Options
4. Tap the Play icon to listen to the recording. Tap Delete Recording to remove the recording and go to 5.
5. Tap Delete.
Bria plays or deletes that call recording. Deleting the call removes the recording but all other call details remain
in the call log entry in History.
Share a Recording
1. Go to the History tab on the navigation panel.
2. Tap
beside the call with the call recording indicator.
Bria iPhone Edition User Guide version 3.9
31
CounterPath Corporation
Advanced Calling Options
3. Tap Share Recording.
4. Choose what app you want to use to share the recording. You will see Airdrop, Message, and Mail. You
may see additional apps you can use to share a recording depending on the apps you have installed on your
iPhone.
Bria opens the app you chose to share the recording. Follow any instructions in the chosen app.
You can also manage the recording in iTunes®. Select your device in iTunes, click the Apps tab at the top of the
screen, scroll down to file sharing, then click the Bria icon in the Apps panel. The recordings appear in the Bria
Documents panel.
4.8 Voice Mail
If 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 4) and
• Bria is not running or
• You already have two calls established.
Bria iPhone Edition User Guide version 3.9
32
CounterPath Corporation
Advanced Calling Options
On the iPhone home screen, a small red number indicates the total number of voice mails, missed calls and new
IMs.
On the Bria navigation panel, a small red number on Phone indicates the total number of new voice mail messages you have.
Access Voice Mail
1. Go to the Phone tab on the navigation panel.
2. Tap the voice mail button. The voice mail number appears in the entry field.
Bria plays your voice mail message.
4.9 Change SIP Accounts
If 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.
Bria iPhone Edition User Guide version 3.9
33
CounterPath Corporation
Advanced Calling Options
Using the Dialpad
1. Go to the Phone tab on the navigation panel.Tap
SIP account registered.
2. Tap
. This icon will only display if you have more than one
. 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. Dial the number you want to call and Bria will use the
selected SIP account to place the call.
Using Bria’s Contacts
If Settings > Accounts (SIP) > Account Specific Features > Enable Video, Enable IM & Presence and Enable
SMS on OFF and Preferences > Single Touch to Dial is ON, you cannot change the SIP account to place the call
using Bria’s contacts.
1. Go to the Contacts tab on the navigation panel.
2. Select the contact by tapping on the contact or typing their name in the search bar and tapping on the
contact.
Bria iPhone Edition User Guide version 3.9
34
CounterPath Corporation
Advanced Calling Options
3. Tap the number you want to dial.
4. Tap
.
5. Tap the SIP account from Select Dial-out Account.
You can now tap the Call prompt to complete the call. Bria displays the new SIP account above the Call prompt.
4.10 Pause Dialing for Auto Attendant
If 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;
Bria iPhone Edition User Guide version 3.9
35
CounterPath Corporation
Advanced Calling Options
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 the symbol key on the bottom left
corner to change between symbols and numbers. Use Pause to enter a , (comma), and use Wait to enter
a : (semicolon).
Bria iPhone Edition User Guide version 3.9
36
CounterPath Corporation
Call History
5 Call History
All calls are captured in both Bria’s call History and the iPhone’s native call history when Settings >
Preferences > Native Integration is ON. In History, you can:
•
•
•
•
•
Filter calls.
View call information.
Call, message or video call a number in the History.
Delete one or all calls.
Add or edit contacts.
5.1 Bria Call History
Call Type Icons
Icon
Meaning
Missed Call
Incoming Call
Outgoing Call
and
Recorded Call
View Call Information
1. Go to the History tab on the navigation panel.
2. Tap
to view more information about the call.
Bria iPhone Edition User Guide version 3.9
37
CounterPath Corporation
Call History
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.
Delete a Call
A call log entry in History is deleted using the standard Apple action for revealing the Delete button.
1. Go to the History tab on the navigation panel.
2. Swipe the call to be deleted to the left.
3. Tap Delete to remove a call from the History.
Bria deletes the call from the History.
Delete All Calls
1. Go to the History tab on the navigation panel.
2. Tap
.
Bria iPhone Edition User Guide version 3.9
38
CounterPath Corporation
Call History
3. Tap Clear All Entries.
Bria deletes all the calls from the History.
Create a New Contact
1. Go to the History tab on the navigation panel.
2. Tap
beside the call containing the new contact.
3. Tap Create New Contact.
4. Complete the contact details. Bria populates the phone number automatically.
5. Tap Save.
The contact appears in Bria’s Contacts and in the native iOS contacts.
Add to an Existing Contact
1. Go to the History tab on the navigation panel.
Bria iPhone Edition User Guide version 3.9
39
CounterPath Corporation
2. Tap
Call History
beside the call containing the information you want to add to an existing contact.
3. Tap Add to Existing Contact.
4. Select the Contact you want to add the phone number to.
The contact is updated in Bria’s Contacts and in the iOS native contacts.
5.2 Native Call History
When you have Settings > Preferences > Native Integration turned ON, you can view and place Bria calls from
the iPhone’s native call history.
To place a Bria call from the iPhone’s native call history, tap on a Bria entry. Bria opens and Bria places the call.
Bria iPhone Edition User Guide version 3.9
40
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.
When multiple entries are merged as one entry on iOS, modifying a contact within Bria updates all the contact
sources. For example, if you have set up the contacts from iCloud and Exchange and link the three entries as
one entry on iOS, you see one single contact on Bria with unified information from the three sources. Editing
this contact on Bria also updates contacts on iCloud and Exchange. Use the native Contacts app to update only
one source, such as iCloud.
6.1 Add a Contact
1. Go to the Contacts tab on the navigation panel.
2. Tap +.
3. Complete the contact details you want to include.
4. Tap Save.
The contact is added to Bria’s contacts and the native iOS contacts.
6.2 Edit a Contact
1. Go to the Contacts tab on the navigation panel.
2. Tap the contact that you want to edit.
3. Tap Edit.
Bria iPhone Edition User Guide version 3.9
41
CounterPath Corporation
Contacts
4. Complete the contact details.
5. Tap Save.
The contact is updated in the Bria’s contact and in the native iOS contacts. The softphone number will show
beside Bria in the native iOS contacts.
6.3 Delete a Contact
Contacts are deleted using the standard Apple action for revealing the Delete button.
1. Go to the Contacts tab on the navigation panel.
2. Swipe the Contact to be deleted to the left.
3. Tap the delete button.
The Contact is deleted and no longer shows in Bria’s Contacts or in the native iOS contacts.
6.4 XMPP vCard “preferred” Property
In the vCard entries for XMPP Contacts, the phone number(s) for Work, Mobile, and Home designated as
“preferred” are displayed at the top of the list. This ensures that calls are dialed to the designated preferred
number(s). If there is no “preferred” phone number, the phone numbers display in the order they are received in
the vCard.
Bria iPhone Edition User Guide version 3.9
42
CounterPath Corporation
Contacts
6.5 Favorites
Favorites 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
1. Go to the Contacts tab on the navigation panel..
2. Tap Favorites and tap +.
3. Select the contact you want to add to your Favorites.
4. Tap the phone number you want to add to your Favorites. If you want to add more than one number for the
contact, repeat the process and select the next number.
Bria adds the number to your Favorites list.
Delete a Favorite
Favorites are deleted using the standard Apple action for revealing the Delete button.
1. Go to the Contacts tab on the navigation panel.
2. Tap Favorites.
3. Swipe the Favorite to be deleted to the left.
4. Tap the delete button.
Bria removes the number from your Favorites list. The contact remains in Bria’s Contacts.
6.6 Fields that Must be Updated in iOS
There are some fields that can only be updated through the native iOS contacts application.These fields include:
• Instant Message
• Ringtone: Personalized vibration and ringtone for the contact
Bria iPhone Edition User Guide version 3.9
43
CounterPath Corporation
•
•
•
•
•
•
•
Contacts
Text Tone: Personalized vibration and alert tone for the contact
Address
Birthday
Date: Important dates associated with the contact
Related name: Other contacts that are related to the current contact
Social Profile
Notes
There are some fields that can only be updated through the native iOS contacts application.These fields include:
• Prefix
• Middle name
• Suffix
• Nickname
• Job Title
• Department
Some fields can be updated in Bria’s Contacts or in the native iOS contacts application. These fields include:
• First name
• Last name
• Company name
• Photo
• Softphone
• IM URI
• Phone
• Email
• URL
Bria iPhone Edition User Guide version 3.9
44
CounterPath Corporation
Presence and Messaging
7 Presence and Messaging
With Presence and Instant 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 Instant Messaging is available as an In-app purchase. If you plan to use Presence and Instant
Messaging over SIP SIMPLE, make sure your VoIP service provider supports SIP SIMPLE before purchasing
this option. To purchase, see “Premium Features” on page 86.
7.1 Presence
Presence allows you to share your online status (presence) with contacts who have a softphone number or an
XMPP address. When you launch Bria, your online status is Available. Go to the Messages tab on the
navigation panel to view your status.
You can change your status from Available to Away, Busy, Do Not Disturb, or My Custom Status Note. When
you change your status from Available or specify a custom status note, your status remains as specified until
you update it yourself. 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 My Custom Status Note.
Presence Options
Status My Presence
Means that...
Available
People can call you and send you an IM. If no custom status note is specified, Bria automatically
switches 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.
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’re on the phone, you can still send and receive IMs.
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 Messages tab without any sound.
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.
Bria iPhone Edition User Guide version 3.9
45
CounterPath Corporation
Presence and Messaging
Change Your Status
1. Go to the Messages tab on the navigation panel.Tap on your status. The list of available status options
appears.
2. Tap the status option you want to use.
3. Tap Done.
Bria updates your status.
Create a Custom Status
1. Go to the Messages tab on the navigation panel.Tap on your status. The list of available status options
appears.
Bria iPhone Edition User Guide version 3.9
46
CounterPath Corporation
Presence and Messaging
2. Tap on My Custom Status Note and enter your custom status.
3. Tap Done.
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 Status
1. Go to the Messages tab on the navigation panel. Tap on your status. The list of available status options
appears.
2. Tap on My Custom Status Note and tap the X.
3. Tap Done.
Bria removes the custom status message.
7.2 Buddies
Buddies are contacts that share their online status with you.
Bria iPhone Edition User Guide version 3.9
47
CounterPath Corporation
Presence and Messaging
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
Buddy, Bria sends a Buddy request to the Buddy. 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. You can
resend your Buddy request by tapping Re-request Presence Authorization on the Buddy profile screen.
7.3 Add a Buddy
When 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 to your contacts. These Buddies appear in your Contacts and
Buddies on Bria and in your native iPhone contacts.
For XMPP accounts, your Buddies are stored in an XMPP server, not in your local iPhone 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 your native iPhone contacts.
SIP SIMPLE - Create a New Buddy
1. Go to the Contacts tab on the navigation 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. Enter the Buddy’s softphone address in the Softphone field. The address is typically the username of the
Buddy.
Bria iPhone Edition User Guide version 3.9
48
CounterPath Corporation
Presence and Messaging
6. Tap IM URI and select the Softphone Address.
7. Tap Save.
The Buddy’s presence appears in Bria’s Contacts and Bria’s Buddies list.
SIP SIMPLE - Add an Existing Contact as a Buddy
1. Go to the Contacts tab in the navigation panel.
2. Tap the contact you want to add as a Buddy.
3. Tap Edit.
4. Tap add softphone.
Bria iPhone Edition User Guide version 3.9
49
CounterPath Corporation
Presence and Messaging
5. Enter the Buddy’s softphone address in the Softphone field. The address is typically the username of the
Buddy.
6. Tap IM URI and select the Softphone Address.
7. Tap Save.
The Buddy’s presence appears in Bria’s Contacts and Bria’s Buddies list.
XMPP - Add a Buddy
Make sure your XMPP account is connected to an XMPP server.
1. Go to the Contacts tab in the navigation panel.
2. Tap Buddies and tap +.
3. If prompted, select the XMPP account to which the Buddy should belong. The XMPP account has the
icon beside it.
Bria iPhone Edition User Guide version 3.9
50
CounterPath Corporation
Presence and Messaging
4. Enter the user portion of the jabber jid in Username and the Display name (optional).
5. Tap Save.
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
For XMPP, make sure your XMPP account is connected to an XMPP server. SIP and XMPP Buddies are
deleted using the standard Apple action for revealing the Delete button.
1. Go to the Contacts tab on the navigation panel.
2. Tap Buddies.
3. Swipe the entry you want to delete to the left.
4. Tap Delete.
Bria removes the SIP SIMPLE Buddy from your Buddies but leaves the person in your Contacts in Bria and the
native iOS contacts without presence.
Bria completely removes the XMPP Buddy from Bria’s Buddies list and from the XMPP server.
7.5 Buddy Requests
When 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.
Bria iPhone Edition User Guide version 3.9
51
CounterPath Corporation
Presence and Messaging
Send an XMPP Buddy Request
1. Go to the Contacts tab on the navigation panel.
2. Tap Buddies.
3. Tap the contact you want to request presence information from.
4. Tap Request Presence Authorization.
Bria sends a Buddy request to the contact.
Respond to XMPP Buddy Request
When you have a new Buddy request, you see a notification on the Contacts tab of the navigation panel. 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.
• Decline: The person does not see your online status. You do not see this person on 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.
1. Go to the Contacts tab on the navigation panel.
2. Tap Buddies and tap Requests. The requests tab only appears when you have a Buddy request.
Bria iPhone Edition User Guide version 3.9
52
CounterPath Corporation
Presence and Messaging
3. Tap on the Buddy request.
4. Tap display and enter a display name for the Buddy (optional).
5. Tap Ignore, Accept or Decline.
Bria sends your status to the remote party if you accept the request.
Stop Sending Presence
1. Go to the Contacts tab on the navigation panel.
2. Tap Buddies.
3. Tap the Buddy you want to stop sharing presence with.
4. Tap Stop Sharing Presence.
Bria stops sending your presence information to the contact. If you want to share your presence with them
again, they must send a Buddy request to you.
Bria iPhone Edition User Guide version 3.9
53
CounterPath Corporation
Presence and Messaging
7.6 Send an IM
You can send an instant message (IM) to a Buddy who is online. If you have not added Buddies yet, add a
Buddy first. See “Add a Buddy” on page 48.
If Settings > Preferences > [Enter] As Newline is ON, tap Return to enter a new line. If Settings > Preferences >
[Enter] As Newline is OFF, tap the
icon and select Enter a new line (Return becomes Send).
Using Messages - SIP and XMPP
1. Go to the Messages tab on the navigation panel.
2. Tap IM if SMS and IM both appear.
3. Tap the
compose icon.
4. Tap + or start typing the name of the contact you want to add to the IM.
5. Tap on a contact to select a Buddy and tap Done.
6. Tap inside the message area and type your message.
7. Tap the
icon.
Bria sends the IM.
Bria iPhone Edition User Guide version 3.9
54
CounterPath Corporation
Presence and Messaging
Using Contacts - SIP and XMPP
1. Go to the Contacts tab on the navigation panel.
2. Tap Buddies.
3. Select the contact you want to IM by tapping on the contact or typing their name in the search bar and
tapping on the contact.
4. Tap Send Instant Message.
5. Tap inside the message area and type your message.
6. Tap the
icon.
Bria sends the IM.
Bria iPhone Edition User Guide version 3.9
55
CounterPath Corporation
Presence and Messaging
Using Siri - SIP and XMPP
You can use Siri to send an IM or SMS text when Bria is in the foreground, background, exited, or the iPhone is
locked. The first time you use Siri, you must give permission for Siri to access Bria’s data. The person must be
in Bria’s contacts to send an IM or SMS text using a name.
1. Press and hold the Home button on your iPhone.
2. Ask Siri to “Send text to Joseph Santos using Bria” or “Text 6045551234 using Bria”.
Ask Siri to “Send message to Joseph Santos using Bria” or “Text 6045551234 using Bria”.
Ask Siri to “Send text message to Joseph Santos using Bria” or “Send text to 6045551234 using Bria”.
Bria sends the IM or SMS text.
7.7 View and Reply to an IM
With Bria running, you can reply to an IM when Bria is in the foreground, background or the iPhone is locked.
When Bria is in the Foreground
Bria displays the number on new instant messages (IMs) on the navigation panel.
1. Go to the Messages tab in the navigation panel.
2. Tap the message with a message indicator beside it. The message and any previous messages in the
conversation open.
3. Tap inside the message area and type your message.
4. Tap the
icon.
Bria sends the IM.
Bria iPhone Edition User Guide version 3.9
56
CounterPath Corporation
Presence and Messaging
When Bria is in the Background
When Bria is in the background, you receive a notification that you have a new message and the number of
messages shows on Bria’s icon.
1. Tap on the notification. The message opens in Bria.
2. Type your reply.
3. Tap the
icon.
Bria sends the IM.
Bria iPhone Edition User Guide version 3.9
57
CounterPath Corporation
Presence and Messaging
When the iPhone is Locked
When the iPhone is locked, you receive a notification on the home screen when you have a new IM.
1. Slide the notification left to reply on the lock screen. (Sliding the notification to the right requires your
passcode and opens the message in Bria.)
2. Tap View or Clear. View allows you to respond to the message. Clear hides the notification.
3. Type your message and tap Send.
Bria sends the IM.
Pre-Defined Canned Messages
Bria offers several pre-defined messages so you can quickly respond to an IM. The messages you can choose
from are:
• Are you there?
• Have time to eat?
• Have time to chat?
• Busy... I’ll IM you later.
• Busy... I’ll call you later.
Bria iPhone Edition User Guide version 3.9
58
CounterPath Corporation
•
•
Presence and Messaging
Driving... I’ll IM you later.
Driving... I’ll call you later.
1. Tap the message you want to respond to.
2. Tap the
. This brings up the list of canned messages.
3. Tap the canned message you want to use and tap the
icon.
Bria sends the canned message.
7.8 Send an SMS
You can send an SMS from your SIP account to PSTN mobile phone numbers, if your VoIP service provider
supports this feature. Before sending an SMS, make sure Settings > Preferences > Enable SMS and Settings >
Accounts (SIP) > Account Specific Features > Enable SMS are ON.
Using Messages
1. Go to the Messages tab on the navigation panel.
2. Tap SMS if SMS and IM both appear.
3. Tap the
compose icon.
4. Tap + or start typing the name or number you want to send the SMS to.
Bria iPhone Edition User Guide version 3.9
59
CounterPath Corporation
Presence and Messaging
5. Tap on the contact you want to send an SMS to.
6. Tap the number you want to send an SMS to.
7. Add more recipients using the above method (optional).
8. Tap inside the message area and type your message.
9. Tap the
icon.
Bria sends the SMS.
Using Contacts
1. Go to the Contacts tab on the navigation panel.
2. Select the contact you want to send an SMS to by tapping on the contact or typing their name in the search
bar and tapping on the contact.
Bria iPhone Edition User Guide version 3.9
60
CounterPath Corporation
Presence and Messaging
3. Tap the number you want to send an SMS to.
4. Tap the SMS prompt.
5. Tap inside the message area and type your message.
6. Tap the
icon or tap Send on the keypad.
Bria sends the SMS.
7.9 XMPP Group Chat
You 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 Works
In 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. Buddies must be online (registered to the XMPP server) or
they do not receive your invitation and cannot join the 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.
Bria iPhone Edition User Guide version 3.9
61
CounterPath Corporation
Presence and Messaging
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 Chat
1. Go to the Messages tab on the navigation panel.
2. Tap IM if SMS and IM both appear.
3. Tap the
compose icon.
4. Tap +.
5. Tap on the Buddies you want to add to the group chat. An orange check mark appears on top of their avatar.
6. Tap Done when you finish selecting Buddies. The names of the selected Buddies displays beside To:. If you
need to delete a participant, long press the participant you want to delete and tap
on the keypad.
7. Tap inside the message area and type your invitation.
8. Tap the
icon.
Bria iPhone Edition User Guide version 3.9
62
CounterPath Corporation
Presence and Messaging
Bria sends the group chat invitation. Buddies join the chat automatically or after accepting the invitation,
depending on the client they are using. A Buddy who is offline or declines the invitation is not placed into the
group chat.
Add a Participant to a Chat
You can add a new participant to the chat after the chat has started.
1. Go to the Messages tab on the navigation panel.
2. Tap IM if SMS and IM both appear.
3. Tap the chat you want to add a participant to.
4. If it is a one-on-one chat, tap More and select Start Group Chat. If it is a group chat, tap in the To: area.
5. Tap +.
6. Tap on the participants you want to add to the group chat. An orange check mark shows on top of their
avatar. Participants already in the chat have a gray check mark on top of their avatar.
7. Tap Done when you finish selecting Buddies.
Bria iPhone Edition User Guide version 3.9
63
CounterPath Corporation
Presence and Messaging
8. Tap inside the message area and type your invitation.
9. Tap the
icon.
Bria sends an invitation message to the new participants. The new participants are gray until they join the chat.
Join a Group Chat
When 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 Account
Unregister your XMPP to leave all group conversations.
1. Go to the Settings tab on the navigation panel.
2. Tap
beside your XMPP account.
3. Tap Disconnect.
Your XMPP account is unregistered and Bria removes you from all group chats. Make sure to Connect to use
your XMPP account again.
Delete a Conversation
Deleting a group chat on the Messages tab lets you leave the chat. You will not be able to come back to the chat
or view the chat history. Conversations are deleted using the standard Apple action for revealing the delete
button.
1. Go to the Messages tab on the navigation panel.
Bria iPhone Edition User Guide version 3.9
64
CounterPath Corporation
Presence and Messaging
2. Tap IM if SMS and IM both appear.
3. Swipe the message you want to delete to the left.
4. Tap Delete.
Bria deletes the group chat.
7.10 Work with Message History
From the Message History, you can:
• Re-send messages.
• Copy, delete, or forward messages.
Resend a Message
If there is an error sending a message, a red icon appears beside the message.
1. Tap
to resend the message.
Bria attempts to resend the message.
Copy or Delete Messages
You can copy or delete a single message or selected messages rather than deleting an entire conversation.
1. Go to the Messages tab on the navigation panel.
Bria iPhone Edition User Guide version 3.9
65
CounterPath Corporation
Presence and Messaging
2. Tap IM if SMS and IM both appear.
3. Long tap a message you want to copy or delete.
4. Tap Copy or Delete for a single message. Tap More to copy or delete multiple messages and go to step 5.
5. Tap the messages you want to Delete or Copy. A check mark shows up beside each selected message.
6. Tap Delete or Copy. If you are deleting messaging go to step 7.
7. Tap Delete # Messages to confirm you want to delete the selected messages.
Bria copies or deletes the selected message(s). Bria copies the message(s) to the clipboard. You can paste the
messages in Bria or in another app.
Forward Messages
You can forward a single message or several messages from a conversation.
1. Go to the Messages tab on the navigation panel.
Bria iPhone Edition User Guide version 3.9
66
CounterPath Corporation
Presence and Messaging
2. Tap IM if SMS and IM both appear.
3. Long tap a message you want to forward.
4. Tap Forward for a single message and go to step 7. Tap More to copy or delete multiple messages.
5. Tap the messages you want to forward. A check mark shows up beside each selected message.
6. Tap Forward.
7.
Tap +.
8. Tap on a contact to select a Buddy and tap Done. (You can select multiple recipients).
9. Tap the
icon to forward the message.
Bria forwards the message(s) to the selected Buddies. Bria groups multiple messages into one message.
Bria iPhone Edition User Guide version 3.9
67
CounterPath Corporation
Presence and Messaging
Use Emoticons/Emoji
Bria supports the iOS Emoji keyboard. To add an emoticon in your message, add the Emoji keyboard on iOS.
On Bria, switch keyboards by tapping the globe icon on the keyboard.
Add the Emoji keyboard on iOS
1. Go to iOS Settings > General > Keyboard.
2. Tap Keyboards, then Add New Keyboard.
3. Scroll down and tap Emoji.
Bria iPhone Edition User Guide version 3.9
68
CounterPath Corporation
Settings
8 Settings
1. This section describes the settings that appear in:
• Accounts – see page 69.
• SIP Accounts – see page 70.
• Dial Plan (Numbered Prefixes) – see page 70.
• Account Specific Features – see page 70.
• Account Advanced – see page 72.
• XMPP Accounts – see page 75.
• Account Specific Features – see page 75.
• Account Advanced – see page 75.
• Network Traversal – see page 76.
• Custom DNS Servers – see page 78.
• Preferences – see page 79.
• Advanced Settings –see page 83.
• Premium Features – see page 86.
• Share – see page 88.
8.1 Accounts
Go to Settings > Accounts to make changes in the following fields.
All the fields on this screen must be supplied by your VoIP service provider or your XMPP service provider.
Bria iPhone Edition User Guide version 3.9
69
CounterPath Corporation
Settings
Accounts (SIP)
To change these fields on an existing account, unregister the account first or turn Enabled OFF for the account.
Field
Description
Account Name
Enter a name for each account to identify different accounts when you have multiple
accounts.
Enabled
• ON: Sets the account as active.
• OFF: You are not using this account so you do not want the account register
automatically.
USER DETAILS
Display as
Your name. This is your Caller ID, if supported or just your phone number.
Username
User portion of your SIP Address of Record (AOR). For example, if your account is
6045551234@myVoIPProvider.com, 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.
Domain
If your account is 6045551234@myVoIPProvider.com, 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 Dialpad to access your voice mail.
Provided by your VoIP service provider. (See “Set Up a SIP Account” on page 4.)
Dial Plan (Number Prefixes)
Optional. See “Dial Plan (Number Prefixes)” on page 70.
Account Specific Features
See “Account Specific Features (SIP)” on page 70.
Account Advanced
See “Account Advanced (SIP)” on page 72.
Dial Plan (Number Prefixes)
Field
Description
Name
The name of the dial plan rule. (See “Set Up a Dial Plan” on page 9.)
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.
Account Specific Features (SIP)
Field
Description
MOBILE DATA NETWORK
Bria iPhone Edition User Guide version 3.9
70
CounterPath Corporation
Field
Description
Disable Mobile Data
Appears when Settings > Preferences > Use When Available is ON.
Settings
• 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.
Data charges with your mobile carrier may apply.
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 86.)
• 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 keypad, 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 Send on the video screen.
Auto Speaker On
Appears when Settings > Accounts > Account Specific Features > Enable Video is ON. This setting is
ignored if Preferences > Native Integration is ON, If you answer the call using the iPhone, audio is
sent through the iPhone. If you answer the call using a Bluetooth device, audio is sent through the
Bluetooth device.
This setting could solve a problem where audio calls are treated as video calls (thus the speaker comes
on automatically).
• ON: Applies to iPhone only. While headsets/Bluetooth are connected to Bria, the sound always
comes from headsets/Bluetooth regardless of this setting.
• OFF: Allows you to hear the sound from the earpiece.
IM AND PRESENCE
Enable IM & Presence
Available when Settings > Preferences > Enable IM & Presence is ON.
• 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.
Bria iPhone Edition User Guide version 3.9
71
CounterPath Corporation
Settings
Field
Description
Subscribe Refresh
Appears when Settings > Account Specific Features > Enable IM & Messaging is ON.
Interval for subscribing 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.
• 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.
Account Advanced (SIP)
Field
Description
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.
Auth Name
Complete this field only if your SIP provider gave you an authorization name. Most providers do
not use this field.
NETWORK TRAVERSAL
Current Strategy
See “Network Traversal” on page 76.
IP VERSION
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 iOS native
HTTP/S framework for these connections.
•
•
•
•
Mobile IP Version
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
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 DTMF.
If Bria recognizes that RFC 2833 or SIP INFO fails, it sends Inband DTMF instead.
CALL DIALING
Bria iPhone Edition User Guide version 3.9
72
CounterPath Corporation
Settings
Field
Description
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)
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.
• Automatic
• 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 iOS multi-tasking support; i.e. receive 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 iPhone; contact your VoIP service provider. Also allows you to take
advantage of iOS multi-tasking support; i.e. receive incoming calls when Bria is sleeping in
the background. This preserves battery.
Encrypt Audio
Encrypt a phone call at the media (audio) level using SRTP. 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.
SIP REGISTRATION
Incoming Calls
• ON: Receive calls on Bria.
• 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.
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.
TLS CERT MANAGEMENT
Bria iPhone Edition User Guide version 3.9
73
CounterPath Corporation
Settings
Field
Description
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.
CUSTOM DNS SERVERS
DNS Servers
See “Custom DNS Servers” on page 78.
SIP MISCELLANEOUS
Show Miscellaneous
Displays miscellaneous settings.
Wi-Fi NAT64 Support
Appears when Settings > Account Advanced > Show Miscellaneous is ON. 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 (e.g. 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
Appears when Settings > Account Advanced > Show Miscellaneous is ON. This settings has the
same function as Wi-Fi NAT64 Support except it applies to mobile data networks.
Enable PRACK
Appears when Settings > Accounts > Account Advanced > Show Miscellaneous is ON.
• 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.
Passive Session Timer
Appears when Settings > Accounts > Account Advanced > Show Miscellaneous is ON.
Controls the use of session timers on SIP accounts. The session timer is used to determine if the
call is still active.
• 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.
Only choose OFF if advised by your VoIP service provider.
Connection Reuse
Appears when Settings > Accounts> Account Advanced > Show Miscellaneous is ON.
• ON: Bria uses existing connections by adding the alias parameter in the Via header, as
specified in RFC5923. Changing this setting might solve problems with dropping or holding
calls.
Enable IMS
Appears when Settings > Accounts> Account Advanced > Show Miscellaneous is ON.
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
Bria iPhone Edition User Guide version 3.9
74
CounterPath Corporation
Settings
Accounts (XMPP)
To change these fields on an existing account, first disconnect the account or turn Enabled OFF.
Field
Description
Account Name
Enter a name for each account to identify different accounts when you have multiple
accounts.
Enabled
• ON: Set the account as active. Typically ON.
• OFF: You are not using this account so you do not want the account register
automatically.
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 75..
Account Advanced
See See “Account Advanced (XMPP)” on page 75..
Account Specific Features (XMPP)
Appears when Settings > Preferences > Use When Available is ON.
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.
Account Advanced (XMPP)
Field
Description
ACCOUNT ADDITIONAL
Out. Proxy
Complete this field only is 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. The expected range is from
-128 to 127. Default is 0.
IP VERSION
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 iOS
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
Bria iPhone Edition User Guide version 3.9
75
CounterPath Corporation
Settings
Field
Description
Mobile IP Version
This settings has the same function as Wi-Fi IP Version except it applies to mobile data networks.
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), indication that the
connection is still active. The default is 300 seconds.
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.
Network Traversal
The Network Traversal Strategy can be found in Settings > Accounts (SIP) > Account Advanced. You can
configure separate NAT settings for each SIP account, such as STUN, ICE, TURN, and RPort.
Before you make changes in Settings > Accounts (SIP) > Account Advanced > Current Strategy, disable your
account by tapping Unregister. The Account Status displays No Registration. Enable your account when you
have finished making changed.
Field
Description
NETWORK TRAVERSAL STRATEGY
Application Manged
Bria uses the specified STUN server to discover the public address of your device, and presents
your public address when negotiating media routing. This setting has Use DNS SRV turned ON.
Server Managed
Bria presents the iPhone’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. This setting has Use DNS SRV
turned ON.
Custom Configuration
Allows you to configure the network traversal strategy for SIP signaling, STUN/TURN server,
and media routing.
SIP NETWORK TRAVERSAL
RPort WiFi
• 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 you
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.
Bria iPhone Edition User Guide version 3.9
76
CounterPath Corporation
Settings
Field
Description
Outbound WiFi
• 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 (e.g. 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
The username to connect to the STUN/TURN server. Usually provided by your system
administrator or your VoIP service provider.
Password
The password to connect to the STUN/TURN server. Usually provided by your system
administrator or your VoIP service provider.
MEDIA NETWORK TRAVERSAL
Use STUN WiFi
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 WiFi
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, specifically, must use draft 19 of the ICE standard.
• OFF: Try turning ICE OFF if you are not the iPhone 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 WiFi
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.
Bria iPhone Edition User Guide version 3.9
77
CounterPath Corporation
Settings
Custom DNS Servers
The 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.
Bria iPhone Edition User Guide version 3.9
78
CounterPath Corporation
Settings
8.2 Preferences
Go 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. You can allow/disallow VoIP
calls using a separate setting “Allow VoIP Calls.”
• 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.
Data charges with your mobile carrier may apply.
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 86.
• 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.
GENERAL
Run In Background
On devices using iOS 10 or newer, this setting is always be enabled and hidden when
using TCP or TLS for transport.
On devices using iOS 9 and when using TCP or TLS for transport, you receive incoming
call regardless of this settings.
To receive notifications of incoming calls, notifications must be turned ON under iOS
Settings > Notifications > Bria in addition to Run In Background.
• ON: You are using UDP for transport and you want to receive incoming calls while
Bria is in the background. Turing this setting ON decreases battery life.
• OFF: Turn this setting OFF if you are using TCP or TLS for transport. If this setting is
turned OFF, you will not be able to receive calls if you are using UDP.
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.
CALL HANDLING
Bria iPhone Edition User Guide version 3.9
79
CounterPath Corporation
Settings
Field
Description
Native Integration
Appears on iPhones running iOS 10+. When ON, Bria enables CallKit native call
integration (see “Appendix B: Native Integration” on page 92) and users see the
following differences:
• Easier to answer Bria calls when a device is locked. No need to rely on a small
notification on the unlock screen.
• A native incoming call no longer takes over during a Bria call; it is presented as Call
Waiting. You now have a chance to tell the person that you have to pick up another
call.
• You can switch between a native call and a Bria call.
• All Bria calls are captured in the native dialer call history, with the option to click on
an entry to call back using Bria.
• Improved Bluetooth headset support. You can answer and hang up Bria using the
button on your Bluetooth device.
• CarPlay support.
INCOMING CALL
Play Ringtone
Appears when Settings > Preferences > Native Integration is OFF.
• ON: Bria plays a ringtone for incoming calls.
Custom Ringtone
Appears when Settings > Preferences > Native Integration is ON.
• ON: Use a ringtone configured in Bria for incoming calls.
• OFF: Use a ringtone configured in iOS.
Vibrate
Appears when Settings > Preferences > Native Integration is OFF.
• ON: The iPhone vibrates when you receive a call.
Alert Answer
Appears when Settings > Preferences > Native Integration is OFF.
Controls the behavior of the incoming Bria call prompt (when Bria is in the
background):
• ON: You can immediately answer the call by tapping on the alert.
• OFF: After tapping the alert, you have a choice to answer or decline the call.
Alert Missed
Controls the behavior of the missed call prompt (when you receive a call when Bria is in
the background):
• ON: Bria shows a missed call notification when Bria is in the background.
• OFF: Bria does not send a missed call notification.
Allow Answer on Lockscreen
Appears when Settings > Preferences > Native Integration is OFF.
• ON: Swiping left on the lock screen reveals two options: Decline and Answer. The
Answer button on the lock screen allows you to answer a call without unlocking your
iPhone so you do not need to enter the passcode to answer a call.
• OFF: Swiping left reveals only the Decline option. To answer an incoming call, swipe
right and enter the passcode to unlock your iPhone. Bria is brought to the foreground.
No one else can answer an incoming call if they do not know your passcode.
Ringtone
The default ringtone for incoming calls. Played if no specific ringtone is assigned to the
contact.
Assign ringtones in native iOS contacts.
OUTGOING CALL
Default Account for History
Changes Bria's dialing behavior on call history when multiple SIP accounts are
configured in Bria.
• ON: Bria dials using the default/primary account. A useful option when you want to
use only one account for all outgoing calls.
• OFF (default): Bria dials using the account that received the call.
CALL IN PROGRESS
Bria iPhone Edition User Guide version 3.9
80
CounterPath Corporation
Settings
Field
Description
Background Image
The background image that appears when you are on a call. Swipe the image to the left
to delete it.
Contact Image
Changes the way Bria displays the image of a contact during a call. Add an image to a
contact in the Contact tab of the navigation panel. Make sure your images are smaller in
size so they display faster.
• Don’t Show: Bria does not show an image of the remote party during a call.
• Full Screen: Bria shows an image of the remote party in the full screen a call.
• Small Avatar: Bria shows a small photo of the remote party next to their name during
a call.
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.
Mobile Call Interrupt
Appears when Settings > Preferences> Native Integration is OFF.
When you receive a mobile call while already in a VoIP call, the incoming mobile call
puts the VoIP call on hold. You will not be able to speak to the remote party in the VoIP
call until you answer or decline the incoming mobile call. Bria can play feedback to the
person who is put on hold without any notice.
• Silence: Bria plays nothing.
• Tones: Bria plays beeps every 5 seconds to the person on hold.
• Announcement: Bria plays an audio message to the remote party on hold in English,
“Your call has been interrupted by an incoming mobile call. Please wait for the other
party to return.”
Play Music On Hold
This setting controls music played locally by Bria; it does not control the server side if
your service provider has ability to play music on the server side.
• ON: Play classical music to party on hold. All the participants hear music if it is a
conference call.
• OFF: Default
PHONE NUMBER
Single Touch to Call
When 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.
Show URI Domain
ON: The phone number displayed for an incoming, outgoing, or established call includes
the domain name (for example, 1234@myVoipProvider.com).
OFF (default): The domain name is not displayed.
CLIENT-SIDE CALL FORWARDING
Forward Calls
• ON: Send all incoming calls to a specific number if Bria is enabled and registered.
For iOS 9, Settings > Preferences > Run In Background must be ON as well.
To Number
Appears when Settings > Preferences > Forward Calls in ON.
• The number to forward calls to.
MESSAGING
Enable IM & Presence
This is a premium feature. See “Presence and Messaging” on page 87.
Appears when Presence and Messaging has been purchased.
• ON: Bria can be used for sending instant messages and sharing online status. To use
IM & Presence on a SIP account, Settings > Accounts (SIP) > Account Specific
Features > Enable IM & Presence must be ON.
• OFF: You will not be able to use SIP or XMPP accounts for presence and messaging.
Bria iPhone Edition User Guide version 3.9
81
CounterPath Corporation
Settings
Field
Description
Enable SMS
This is a premium feature. See “Presence and Messaging” on page 87.
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: Bria plays a ringtone when you receive a new message.
Alert Vibration
• ON: Your iPhone vibrates when you receive a new message.
Private When Locked
• ON: Bria does not display the incoming call information on the lock screen and the
notification center.
• OFF: Default
[Enter] As Newline
• ON: Tap the Enter key to add a new line in IM/SMS conversations. Tap the Send icon
to send IM.
• OFF: Tap the Enter key to send an IM. You might want to turn it OFF when using
physical keyboard with the device.
Alert Text Tone
The default text tone for incoming messages. Played if no specific text tone is assigned
to the contact.
Assign text tones in the native iOS contacts.
VIDEO CALLS
Enable Video
This is a premium feature. See “Video Calls” on page 87.
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 video calls on Bria.
Send Landscape
Appears when Settings > Preferences > Enable Video is ON.
• ON: Your video is sent in the landscape orientation. This is a compatibility mode for
older devices that cannot render video in the portrait orientation. Use as an exception.
• OFF: Default
Video Quality
Appears when Settings > Preferences > Enable Video is ON.
• Automatic: (Recommended): Bria selects the best quality to use in a given situation.
• Lower (QCIF): Uses 176 horizontal pixels and 144 vertical lines. Quarter Common
Intermediate Format transfers one fourth the amount of data and consumes less
memory than CIF (Common Intermediate Format).
• Higher (CIF): Uses 352 horizontal pixels and 288 vertical lines.
• High (VGA)*
• HD (720p VP8 only)*
*VGA and HD video are not supported on iPhone 4S.
Bria iPhone Edition User Guide version 3.9
82
CounterPath Corporation
Settings
8.3 Advanced Settings
NOTE: If you make changes to the fields identified by a ▼, you must tap the Apply Changes button at
the bottom of the screen or restart Bria.
Field
VPN SUPPORT
Description
▼
Use VPN If Active
• ON: 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.
• OFF: (default) You are not using a VPN network interface.
MEDIA OPTIONS ▼
Voice Activity Detection
• ON: Audio is not transmitted when no one talking. Turning this feature ON may
reduce bandwidth usage.
• OFF (default): Audio is transmitted when there is no one talking.
Noise Reduction
• ON: Bria attempts to reduce background noise from your microphone. Typically ON
when you are not using a headset.
• OFF: Typically OFF when you are using a headset.
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
SIP Port Range
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: Also open those ports on your firewall. Refer to the applicable firewall
documentation.
RTP Port Range Audio
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: Also open those ports on your firewall. Refer to the applicable firewall
documentation.
RTP Port Range Video
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: Also open those ports on your firewall. Refer to the applicable firewall
documentation.
AUDIO CODECS SELECTION
Mobile Audio Codecs
CounterPath recommends using the default settings. See “Wi-Fi and Mobile Audio
Codecs” on page 85.
Wi-Fi Audio Codecs
CounterPath recommends using the default settings. See “Wi-Fi and Mobile Audio
Codecs” on page 85.
VIDEO CODECS SELECTION
Bria iPhone Edition User Guide version 3.9
83
CounterPath Corporation
Settings
Field
Description
Video Codecs
• H264 - offers 720p HD support.
• VP8
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, to see if it is 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 use the iPhone Configuration Utility to install it to
your device.
The CA cert should appear under iOS Settings > General > Profiles. Downloading the
CA cert via Safari does not install it properly.
ACCOUNT REGISTRATION ISSUES
Alert In Background
SIP MISCELLANEOUS
• 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 iOS Settings > Notifications.
• OFF (default): Bria does not send notifications regarding account registration errors.
▼
Show Miscellaneous
• ON: Displays miscellaneous settings.
Encode # in URI
Appears when Settings > Preferences > Show Miscellaneous in ON.
• 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 90.
Send Log
Tap to upload the current log to Technical Support. See "Appendix A: Troubleshooting"
on page 90.
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 the Refresh button to stop auto refresh and present a snapshot of the most current
statistics.
• To enable auto refresh again, either long-tap the Refresh button, or leave the statistics
page and come back again.
Codecs
Codecs are programs in Bria that are involved in 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.
Bria iPhone Edition User Guide version 3.9
84
CounterPath Corporation
Settings
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.
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 dragging them up or down in the list. Codecs higher in the list are given a higher priority in
the offer when negotiating codecs with the other party. Moving a codec higher should improve its chances of
being chosen.
Wi-Fi and Mobile Audio Codecs
AMR-WB and G.729 Codecs are premium features (see “Purchase a Premium Feature” on page 86).
SILK-Super-Wideband (24k) and OPUS-Full(48k) are only available in iPhone 4S and newer and iPod 5th
generation and newer devices.
Bria offers Opus, SILK - NB, SILK - WB, G.729, AMR - Wideband, G.722, G.711µ, G.711a, 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-Wideband 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
Data usage for the codecs with a fixed bit rate, from high to low usage, is: G.722, G.711, GSM, and G.729a.
Speex, AMR-Wideband, 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. Note the G.722 codec is available on iPhone 3GS and newer and 3rd generation iPod
touch and newer.
Video Codecs Selection
Available Codecs
H264 and VP8 (with 720p HD video support) can be used during a video call over a Wi-Fi or a mobile network.
VGA and HD video are not supported on older devices such as the iPhone 4S.
Bria iPhone Edition User Guide version 3.9
85
CounterPath Corporation
Settings
8.4 Premium Features
NOTE: 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.
Purchase a Premium Feature
1. Go to the Settings tab in the navigation panel.
2. Tap Premium Features.
3. Tap the premium feature you want to purchase.
4. On the Product Detail screen, tap the price button to connect to the iTunes store.
A confirmation prompt appears.
5. Tap Cancel or Buy.
AMR-WB and G.729 Codecs
AMR-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 Codec
Adaptive Multi-Rate wideband (AMR-WB) audio codec is a wideband codec that provides superior sound
quality due to a wider speech bandwidth.
G.729 Audio Codec
G.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.
Bria iPhone Edition User Guide version 3.9
86
CounterPath Corporation
Settings
Presence and Messaging
Presence and Messaging allows you to send instant messages to your Buddies and share your online status
(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 5 to
set up this feature.
Video Calls
With 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 11.
Bria iPhone Edition User Guide version 3.9
87
CounterPath Corporation
Settings
8.5 Share
You can easily share Bria via Twitter and Email.
Twitter
1. Go to iOS Settings > Twitter.
2. Enter your User Name and Password.
3. Tap Sign In if you already have a Twitter account. Tap Create New Account and following the instructions
if you do not have a Twitter account.
4. Go to Bria’s Settings > Share.
5. Tap Twitter. A draft message appears.
6. Change the message and add your location (optional).
7. Tap Post.
Your message is shared on Twitter.
Email
Make sure your email account has been set up on your iPhone.
1. Go to Bria’s Settings > Share.
Bria iPhone Edition User Guide version 3.9
88
CounterPath Corporation
Settings
2. Tap Email. A draft message appears.
3. Enter the email addresses you want to send the email to.
4. Change the message (optional).
5. Tap Send.
Your message is sent.
Bria iPhone Edition User Guide version 3.9
89
CounterPath Corporation
Appendix A: Troubleshooting
Using Bria Diagnostics
If you have a problem with Bria, Technical Support may ask you to turn diagnostics on to capture information.
1.
Go to Settings > Advanced Settings > Verbose Logging. If Verbose Logging is OFF, turn it to ON and tap
Apply Changes.
2. Reproduce the problem you were having.
3.
Go to Settings > Advanced Settings again.
4. Tap Send Log (not Call Statistics).
5. Tap Yes on the Sending Log message.
6. Tap Copy of the Sending Log Success message. The log reference number is on your clipboard.
7. Report this Reference # 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.
Bria iPhone Edition User Guide version 3.9
90
CounterPath Corporation
•
•
•
•
Your Apple device and model.
Any recent changes you have made to your setup of Bria.
Whether you are in your normal Wi-Fi zone or a different Wi-Fi zone.
Whether you normally have mobile data (3G/4G/LTE) enabled on your device and in Bria.
8. Turn OFF Verbose Logging when you are done. Tap Apply Changes.
More Information and Technical Support
Please 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.
Bria iPhone Edition User Guide version 3.9
91
CounterPath Corporation
Appendix B: Native Integration
Interaction between Bria and Native Phone
Native Integration determines the way Bria interacts with the phone that is part of the iPhone. Go to Settings >
Preferences to turn Native Integration ON or OFF. When Native Integration is ON, Bria works with the native
dialer and native contacts. When Native Integration is OFF, native calls take priority over Bria Calls.
Native Integration On
When Native Integration is ON, you can have up to two calls: one native call and one Bria call; or two Bria
calls. Native calls have the same priority as Bria calls.
Outgoing Calls
Existing Call
Result
Bria
None
You can place a Bria call.
Bria
One Bria
You can place a Bria call.
Bria
Two Bria
You cannot place a Bria call. You can only have two Bria calls at a time.
Native
None
You can place your native call.
Native
One Bria
You can place your native call. The Bria call is put on hold.
Native
Two Bria
You cannot place a native call. You can only have two calls at one time.
Incoming Calls
Existing Call
Result
Bria
None
Incoming Bria call rings on your phone.
Bria
One Bria
Incoming Bria call rings on your phone.
Bria
Two Bria
The incoming Bria call goes to your Bria voice mail if it is configured. If not,
the call fails. You can only have two calls at one time.
Native
None
The incoming native call rings on your phone.
Native
One Bria
The incoming native call rings on your phone.
Native
Two Bria
The incoming call goes to your native voice mail if you have it configured.
You can only have two calls at one time.
You can have two Bria calls; or one Bria call and one native call established at the same time. You can swap
between native calls and Bria calls.
Bria iPhone Edition User Guide version 3.9
92
CounterPath Corporation
Native Integration Off
When Native Integration is OFF, you can have up to three calls: one native call and up to two Bria calls. Native
calls take priority over Bria calls.
Outgoing Calls
Existing Call
Result
Bria
None
You can place a Bria call.
Bria
One Bria
You can place a Bria call.
Bria
Two Bria
You cannot place a Bria call. You can only have two Bria calls at a time.
Native
None
You can place your native call.
Native
One Bria
You can place your native call. The Bria call is put on hold.
Native
Two Bria
You can place your native call. The Bria calls is put on hold. This is the
maximum number of calls you can have.
Incoming Call
Existing Call
Result
Bria
None
Incoming Bria call rings on your phone.
Bria
One Bria
Incoming Bria call rings on your phone.
Bria
Two Bria
Incoming Bria call goes to voice mail if it is configured. Otherwise the call
fails.
Native
None
Incoming native call rings on your phone
Native
One or Two Bria
Incoming native call rings on your phone. The native call interrupts your Bria
calls and you cannot hear or speak to the other party until you end or decline
the native call. The Bria parties hear silence, tones, or an announcement
depending on how Mobile Call Interrupt in Settings > Preferences is set up.
Handling Calls with Native Integration Off
To learn how to handle calls with Native Integration ON, see “Handle Incoming Calls” on page 12.
Bria iPhone Edition User Guide version 3.9
93
CounterPath Corporation
Bria is in the Foreground
1. Tap Decline or Answer.
Bria declines or starts the call.
Bria is in the Background
When Bria is in the background, Bria displays a notification for the incoming call. To change the notification
style you receive, go iOS Settings > Notifications > Bria. If you choose Banners, Bria displays the notification
at the top of the screen and it goes away automatically. If you choose Alerts, Bria displays the notification at the
top of the screen and it does not go away until you tap on the notification and handle the call.
Bria iPhone Edition User Guide version 3.9
94
CounterPath Corporation
If Settings > Preferences > Alert Answer is OFF, you are given the Decline or Accept options. If Settings >
Preferences > Alert Answer is ON, Bria starts the call as soon as you tap the notification.
1. Tap the notification.
2. Tap Decline or Answer, if required.
Bria declines or starts the call.
Bria iPhone Edition User Guide version 3.9
95
CounterPath Corporation
Device is Locked
When Bria is running and the iPhone is locked, you receive a notification of the call on the lockscreen.
Answer a Call on the Lockscreen Swiping Right
If Settings > Preferences > Alert Answer is OFF, you are given the Decline or Accept options. If Settings >
Preferences > Alert Answer is ON, Bria starts the call as soon as you enter your passcode.
1. Swipe the call notification to the right.
2. Enter the passcode to the iPhone.
3. Tap Answer, if required.
Bria iPhone Edition User Guide version 3.9
96
CounterPath Corporation
Bria starts the call.
Answer a Call on the Lockscreen Swiping Left
If Settings > Preferences > Alert Answer is OFF, you are given the Decline or Accept options. If Settings >
Preferences > Alert Answer is ON, Bria starts the call as soon as you enter your passcode.
1. Swipe the call notification to the left.
2. Tap View
3. Tap the new notification or tap Answer (if Settings > Preferences > Allow Answer on Lockscreen in ON. If
you tap Answer, the call is answered on the lockscreen. Tap the iPhone’s Home button and enter your
passcode to view the call in Bria.)
4. Enter the passcode to the iPhone.
Bria iPhone Edition User Guide version 3.9
97
CounterPath Corporation
5. Tap Answer, if required.
Bria starts the call.
Decline a Call on the Lockscreen Swiping Right
You can only Decline a call by swiping right if Settings > Preferences > Alert Answer is OFF.
1. Swipe the call notification to the right.
2. Enter the passcode to the iPhone.
Bria iPhone Edition User Guide version 3.9
98
CounterPath Corporation
3. Tap Decline.
Bria declines the call.
Decline a Call on the Lockscreen Swiping Left
1. Swipe the call notification to the left.
2. Tap View or Clear. If you tap Clear, the call continues to ring for the remote party and goes to voice mail if
you have it configured.
Bria iPhone Edition User Guide version 3.9
99
CounterPath Corporation
3. Tap Decline.
Bria declines the call.
Bria iPhone Edition User Guide version 3.9
100
CounterPath Corporation
Appendix C: CarPlay and Bluetooth
Using CarPlay
When Native Integration is ON, Bria can be used with CarPlay-compatible vehicles, but only if you are using an
audio source from the device. If you are playing audio directly from the vehicle, the audio is muted while Bria
runs in a “background” state.
What You Need
•
•
•
•
•
A car that supports Apple CarPlay.
iPhone 5 or newer running iOS 10+.
Bria 3.8.1 or newer.
Native Integration turned ON under Settings > Preferences within Bria.
Connect iPhone to the car via a Lightning cable.
What You Can Do:
•
•
•
•
•
Answer or decline incoming Bria calls via the CarPlay interface.
Make outgoing calls using Bria from Contacts and Call History on the CarPlay interface.
Hear the remote party over the vehicle's sound system.
Switch between vehicle's sound system (displayed as CarPlay on Bria), iPhone, and other Bluetooth
headsets if connected.
Control an established Bria call, such as mute, hold, add call, swap, merge and end.
Note that Siri support (e.g. talking to Siri to make a call using Bria) and video calls are not supported when CarPlay is used. If you want to have video calls, turn OFF Native Integration in Settings > Preferences > Native
Integration.
When Native Integration is Disabled
When the Native Integration setting is OFF in Bria, connecting an iPhone to your car via a Lightning cable
allows you to:
•
•
•
Answer Bria incoming calls on Bria screen on your iPhone (instead of built-in screen in your car).
Hear the remote party over the vehicle's sound system.
Use Bria on your iPhone to mute, end the call, etc.
Bria iPhone Edition User Guide version 3.9
101
CounterPath Corporation
Using Bluetooth to Connect to a Car
If you connect your iPhone to your car using Bluetooth (instead of CarPlay), we recommend that you turn ON
Settings > Preferences > Native Integration so you can answer and hang up a call using car controls, such as
buttons on the steering wheel, instead of tapping on Bria’s screen.
Using Bluetooth Headsets
When you have Native Integration ON, you can answer and end a call by pressing a button on your Bluetooth
device. However, if you are already on a call, be aware:
•
•
Pressing once (or a short press) on the Bluetooth button performs End & Accept. This means that the
original call ends and the new call begins.
Pressing twice (or a long press) performs Hold & Accept. This means that the original call is put on hold
and the new call begins.
Bria iPhone Edition User Guide version 3.9
102
CounterPath Corporation
Appendix D: Glossary
Bria call
Codec
DTMF
Home button
IM
ICE
IP address
IVR
Media
Native call
Native phone service
PSTN
Presence
Signaling
SIP
SIP account
softphone address
STUN
TURN
Wi-Fi call
XMPP account
A call made using the Bria call as compared to a “native call.”
Codecs are programs in Bria involved in transmitting audio. Each codec has different
characteristics, and therefore each works better in some situations than in others.
Dual-tone multi frequency. DTMF is the system that is used in interactive voiceresponse 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
dialpad or keyboard.
The button at the bottom of the iPhone or iPod touch.
Instant Messaging. A technology that lets users send text messages for near
instantaneous delivery and display on each others’ devices.
Interactive Connectivity Establishment. A method for traversing a firewall.
A unique number that identifies a device. Devices on a network use the IP address to
communicate with each other.
Interactive Voice Response. IVRs use DTMF.
The audio portion (and the video portion if any) of a call. Compare to “Signaling.”
A call made using the phone service that comes with the iPhone. Does not apply to the
iPod touch.
The phone service that comes with the iPhone.
Public Switch Telephone Network. The traditional land-line phone network.
An instant messaging feature that allows users to share information about their online
status.
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.
Session Initiation Protocol. The signaling protocol followed by Bria for handling
phone calls.
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.
The address used to connect to a SIP endpoint. In other words, the “phone number”
used in a VoIP phone call. For example, sip:joseph@domainA.com.
Simple Traversal of UDP through a firewall or NAT.
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.
A Bria call made over the Wi-Fi Internet. To make a Wi-Fi call, you must be in a
Wi-Fi zone.
An account that provides the user with the ability to send IMs and view other people’s
presence.
Bria iPhone Edition User Guide version 3.9
103
CounterPath Corporation
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 iPhone 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 iPhone Edition User Guide version 3.9
104
Was this manual useful for you? yes no
Thank you for your participation!

* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project

Download PDF

advertising