Bria Android Edition User Guide
CounterPath Corporation CounterPath Corporation Suite 300, One Bentall Centre 505 Burrard Street, Box 95 Vancouver, BC V7X 1M3 Tel: 604.320.3344 sales@counterpath.com www.counterpath.com © March 2012 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.
Contents About Bria Android Edition..........................................................................................................1 Configuring Bria Android Edition ................................................................................................3 Getting Ready .........................................................................................................................3 Setting up ..........................................................................................
CounterPath Corporation ii
Bria Android Edition User Guide 1 About Bria Android Edition Bria Android Edition is a SIP-based phone for an Android phone. With Bria Android Edition (Bria), you can use the Wi-Fi internet connection on your Android phone to make and receive calls without using your mobile data plan. In addition, you can use the mobile data connection for phone calls when you are not in a Wi-Fi zone.
CounterPath Corporation • Nexus One™ • • • • • • Samsung Epic™ 4G Android Smartphone (SPH-D700) Samsung Galaxy S i9000 Samsung Galaxy S Fascinate™ 3G+ (SCH-i500) Samsung Galaxy S Vibrant™ (GT-i9000) Samsung Galaxy S Captivate™ (SGH-i896) Samsung Galaxy S2™ • • • • • • • DROID™ by Motorola DROID™ 2 by Motorola DROID™ X by Motorola DROID BIONIC by Motorola MOTOROLA ATRIX™ MOTOROLA CHARM™ MOTOROLA MILESTONE™ • Sony Ericsson XPERIA™ X10 Operating System Your device must run on Android V2.1 or later.
Bria Android Edition User Guide 2 Configuring Bria Android Edition We strongly recommend that you 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 (if you have one) and not in a network such as an internet cafe. 2.1 Getting Ready Obtain Account Information from your VoIP Service Provider • • Your username, password and domain. Your voicemail number, if your service provider provides this service.
CounterPath Corporation 2.2 Setting up Tap Tap Select your VoIP service provider, if it is on the list. Otherwise, select Generic SIP Account. Complete the User Details section and Voice Mail section (optional) with the information provided by your service provider When done, tap the Back key. Then tap the checkmark to register When you have successfully registered, tap the Back key and then tap the Phone icon.
Bria Android Edition User Guide Troubleshooting Registration If you cannot log in, ask your VoIP service provider if they want Bria to use STUN (to discover your public IP address). If they do not want you to use STUN, go to More > Settings > Advanced Settings > Network Traversal Strategy and choose the Server Managed profile. For complete settings information, see page 36. Troubleshooting Audio on a Phone Call 1. Go to More > Accounts, then tap the account.
CounterPath Corporation Setting up Multiple Accounts You can set up more than one account if you have service from more than one VoIP service provider. Tap Set up the account in the usual way Enable the account Setting the Primary Account One account is always set as the primary account. This account is used by default for outgoing calls. You can change the primary account or you can override it for one call (page 14).
Bria Android Edition User Guide 2.3 Setting up Presence and Instant Messaging Presence and Messaging is a premium feature available as an in-app purchase. With Presence and Messaging, you can share online status with your buddies (such as Available, Away, On the phone), and exchange instant messages with them. Bria supports the XMPP protocol and the SIP SIMPLE protocol. You can create an XMPP account on Bria with your Gmail or Facebook credentials to communicate with your buddies.
CounterPath Corporation Go to More > Accounts. Tap Tap XMPP Account status Complete the User Details section with the information provided by your service provider. Tap the Back key. Make sure that the account shows a checkmark. Tap the Back key, and tap Contacts > Buddies to see who is online. To add a new buddy, see page 29. Account Status Status Meaning The account is in the process of registering. The account is connected to an XMPP server, and can be used to send and receive instant messages.
Bria Android Edition User Guide For SIP SIMPLE To use the Presence and Messaging feature for SIP SIMPLE, you need to change the setting on your SIP account. Then add a new buddy to see other people’s presence (see page 29). If you are new to Bria and have not set up your SIP account for making phone calls yet, it will be easier to set up Bria as a phone first (see page 4), then follow the steps below. Tap More > Accounts. Unregister your SIP account to make changes.
CounterPath Corporation 10
Bria Android Edition User Guide 3 Making Phone Calls 3.1 Starting and Quitting Bria Start Bria. After a few seconds, the Bria Phone screen appears. Tap This icon indicates Bria is running and ready The contacts tab is automatically populated with contacts from your Android contact list. To quit the Bria application: 1. Display the Phone, Contacts, or Call Log screen or the first More screen. 2. Tap the Menu button on the Android phone and choose Exit.
CounterPath Corporation 3.2 Interaction between Bria and Native Phone Contacts • Bria uses your contacts saved on your phone. Bria’s contacts are continually synchronized with your native contacts; adding, modifying or deleting a contact from one list updates the other list. Placing Calls • • You can place a Bria call so long as you are not already on a native call or not already on two Bria calls. You can place a native call regardless of the state of Bria.
Bria Android Edition User Guide 3.3 Placing a Bria Call You can place a Bria call unless you are already on a native call or already on two Bria calls. Using the Dial Pad Enter the phone number Tap From the Bria Contact List Tap the Contacts tab at the bottom of the screen Search for the contact and tap it If phone numbers from your contact list need to be modified (for example, to remove extra characters such as +), you can set up a dial plan. See page 47.
CounterPath Corporation Making a Call from another Account If you have more than one account enabled, you can change the account to use on a given phone call. The account currently being used for calls Dial a phone number. Long-tap to display the Choose Account menu This account will be used only for this call. To permanently change the account, see page 6. Tap the account you want to use From the Bria Contact List Tap This account will be used only for this call.
Bria Android Edition User Guide 3.4 Handling Incoming Calls If you are on a native call or already on two Bria calls, the incoming call does not ring on your phone: it goes to Bria voicemail instead. Tap to accept or decline the call When Bria Is in the Background If you receive an incoming call when Bria is in the background, Bria will automatically come to the foreground so you can handle the call.
CounterPath Corporation 3.5 Placing a Second Bria Call When you are already on one Bria call, you can place a second Bria call using the dial pad, from your Contact list, or from the Call Log. Using the Dialpad Place the call on hold first, if desired Tap add call Dial the number of the second person The live call always appears on top Tap add call The second call is dialed When the call connects, the first call is put on hold. You are now speaking to the second person.
Bria Android Edition User Guide From the Contact List If you want to go back to the first call, tap the Phone tab. Place the current call on hold first, if desired Tap add call Tap Contacts Find the person and tap. (If the list is long, search for the name; see page 13) Tap a desired number. Tap Call. The second call is dialed. When the call connects, the first call is put on hold. You are now speaking to the second person.
CounterPath Corporation 3.6 Handling Established Calls Handling Two Bria Calls The live call always appears at the top To switch to the other person, tap Swap Handling a Bria Call and a Native Call If you accept an incoming native call, any live Bria call goes on hold. Use the Android navigation bar to switch between calls You will not be able to take the Bria call off hold until you end the native call. You cannot start another Bria call until you end the native call.
Bria Android Edition User Guide 3.7 Unattended (Basic) Transfer You can transfer the current Bria call to a second person without first talking to the second person. Using the Dialpad Place the call on hold, if desired Tap add call Dial the number of the person to transfer to Tap Transfer A call is placed to the transferee.
CounterPath Corporation 3.8 Attended Transfer You can speak to the second person first then transfer the first person to them. It does not matter which call is live and which is on hold Establish two calls (page 16) Tap Transfer A message appears Both calls end on your side 3.9 Conference Call When you have two Bria calls established, you can merge the calls into a three-way conference call.
Bria Android Edition User Guide 3.10 Call Log Tap the Call Log tab.
CounterPath Corporation Adding a Contact from the Call Log Quick-tap or long-tap The long-tap menu The quick-tap screen Tap Tap the desired item The contact detail screen appears. Tap Save. The contact is saved on your native contacts as well.
Bria Android Edition User Guide 3.11 Accessing Voicemail If your VoIP service provider provides a voicemail service, then incoming calls go to voicemail if: • • • Bria is not running. You are currently on a native call. You already have two Bria calls established. The voicemail indicator Tap the voicemail icon; the voicemail number appears in the entry field. Place the call in the regular way.
CounterPath Corporation 24
Bria Android Edition User Guide 4 Presence and Instant Messaging With Presence and Instant Messaging, you can share your online status (presence) and exchange instant messages with the contacts who have a softphone number or an XMPP address. You can also 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.
CounterPath Corporation By Selecting a Contact Tap Contacts. Or long-tap a buddy then you will see “Send IM“. Tap Buddies and quick-tap a buddy. An XMPP account A SIP account Tap to send an IM. Type a message. Tap to send.
Bria Android Edition User Guide 4.2 Sending an SMS You can send an SMS from your SIP account to mobile phone numbers if your VoIP service provider supports this feature. Before sending an SMS, make sure SMS is enabled (ON) on Preferences and on your SIP account. By Selecting a Contact Tap Contacts. Search for and long-tap the contact. Tap SMS. Choose a different number if desired. Type a message, and tap the Return key to send.
CounterPath Corporation 4.3 Receiving an IM and SMS An alert comes up when you receive an IM or SMS. Scroll down from the top. Tap. Tap.
Bria Android Edition User Guide 4.4 Viewing Others’ Status (Adding a Buddy) To view someone’s online status, you need to add this 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. For XMPP accounts, your buddies are stored in an XMPP server, not in your local Android phone contacts. This means the name and presence of your buddies appear in your Buddies list (not in All Contacts) while your XMPP account is connected.
CounterPath Corporation SIP Accounts To see someone’s online status, you can either add a new contact as a buddy, or edit an existing contact. Editing an existing contact to see online status Tap. Search for the contact and longtap the entry. Tap Edit. Tap this label to change it to Softphone. Enter a softphone number, such as 1575. The domain name will be populated. Tap the arrow beside Presence and IM. Tap a softphone number, and tap Save. The person appears both in your Contacts and Buddies lists.
Bria Android Edition User Guide Adding a new contact as a buddy Tap. Tap Buddies, and tap Android Menu button. Tap New buddy. Tap to change this to Softphone. Enter a softphone number. Tap the arrow beside Presence and IM. Tap the softphone number, and tap Save. The person appears both in your Contacts and Buddies lists.
CounterPath Corporation 4.5 Setting Your Own Status When you start Bria, your online status becomes “Available”. When you make or receive a phone call, Bria automatically updates your status to “On The Phone” if your online status is “Available” and no custom status note is specified. You can change your status from “Available” to other statuses such as “Busy” or “Away”.
Bria Android Edition User Guide 4.6 Responding to Buddy Requests When using an XMPP account, you may receive a buddy request. You must respond to the request. A pop-up message comes up when someone adds you as a buddy . Tap a desired option. When using a SIP account for presence, you will not receive a buddy request. As soon as the person on the other end registers your softphone number on the client, the person will see your presence without your acceptance.
CounterPath Corporation 34
Bria Android Edition User Guide 5 Settings Tap More at the bottom of the screen. More screen • • • • • Settings Screen Accounts: See page 36. Settings > User Preferences: See page 40. Settings > Advanced Settings: See page 41. Settings > Logging Preferences. See “Troubleshooting” on page 46. Premium Features: See page 45.
CounterPath Corporation 5.1 Account Settings All the information for the fields on this screen must be supplied by your VoIP service provider. To change these fields on an existing account, you must first unregister the account. SIP Accounts Field Description Account Name Change the name as desired. For example, “business account” Display Name Your name. Other people may see this as the caller ID (or they may see just your phone number).
Bria Android Edition User Guide Account Advanced (SIP) Field Description Global IP • On (checked): Bria will publish its public IP address at the signaling level. The public address may not work with some NATs or firewalls. • Off: Bria will publish its private IPs at the signaling level. Typically, you turn this field off only if instructed to do so by your VoIP service provider or system administrator.
CounterPath Corporation Field Description Keep Alive - Wi-Fi Interval A “keep alive” message is a mechanism for maintaining a “pinhole” through your firewall so that phone calls proceed smoothly. The interval specifies how often the message is sent (in seconds). If you are experiencing problems during a Wi-Fi call (a call made over the Wi-Fi internet connection), try setting this interval to a lower number such as 20.
Bria Android Edition User Guide Account Advanced (XMPP) Field Description Resource Used to identify an XMPP session when you log in to multiple clients with this XMPP account (for example, /work or /home). Priority The priority of the resource. The range is from -128 to 127. TCP Keepalive Interval Specifies how often a ping message is sent to the XMPP server (in seconds). The default is 300.
CounterPath Corporation 5.2 User Preferences Field Description Allow Cellular Data • On (checked): When a Wi-Fi connection is not available, Bria will attempt to place calls or exchange messages using the mobile data network. Data charges with your mobile carrier will apply. If you turn this setting on, we recommend you purchase the G.729 codec (page 45) because it provides better audio quality on 3G/4G calls.
Bria Android Edition User Guide 5.3 Advanced Settings When you changed an advanced setting, you may be prompted to apply the changes. In order to apply the changes, Bria will automatically unregister and reregister all enabled accounts. This may take a few seconds. Field Description Send DTMF using The method used for DTMF, sent when you press a number key when dealing with an auto attendant (such as “press 1 for customer service”).
CounterPath Corporation Field Description Speakerphone Fix If the speakerphone is always turned on in Bria, turn on this setting and see if that forces the speakerphone to turn off. If the speakerphone is still on, turn this setting off again. Audio Input Source • This setting controls how the device processes the audio input from Bria. If the person you are talking to is receiving poor audio, try changing the audio source.
Bria Android Edition User Guide Field Description STUN Server Used only if STUN is on. The default is stun.counterpath.com but we recommend that you change this to an address provided by your VoIP service provider. CounterPath cannot guarantee the availability of their STUN server.
CounterPath Corporation Audio Codecs Selection 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. Novice and Non-technical Users We recommend you enable all codecs and let Bria select the best codec to use in a given situation. 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.
Bria Android Edition User Guide 5.4 Premium Features Premium Features offers items that you can purchase to use on Bria. •G.729 codec is a narrowband codec that is intended for low bandwidth use. It is particularly recommended if you will be making calls over 3G/4G because it provides better audio quality on your mobile data connection. •Presence and Messaging allows you to send instant messages to your buddies and share your online status (presence) with them.
CounterPath Corporation A Troubleshooting More Information • • You can view Frequently Asked Questions at https://support.counterpath.com/default.asp?W546. You can visit the Bria Android Edition forum at forums.counterpath.com > Bria Android Edition. Using Bria Diagnostics When you have a problem with Bria, customer support may ask you to turn on diagnostics in order to capture information. 1. Go to More > Settings > Logging Preferences and turn on Verbose Logging. 2. Reproduce the problem. 3.
Bria Android Edition User Guide B Dial Plans You can create a dial plan in order to modify a phone number used in a phone call (the “input”), in order to ensure the call is placed successfully. For example, you could create a dial plan to change any number that starts with “+1613” to just “613”. Setting up Dial Plans You can create up to three dial plans for an account. Dial plans are account-specific, so make sure you set up a plan for each account that needs one.
CounterPath Corporation Designing the Dial Plan A dial plan has two parts: • • A pattern (the match number) that the phone number (the input) must match. The modification to make if the input matches that pattern: removing a prefix, adding a prefix, or removing one prefix and adding another one. 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.
Bria Android Edition User Guide C Glossary Android icon Bria call DTMF ICE IM IP address IVR Media Native call Native phone service PSTN Presence Signaling SIP SIP account softphone address STUN Wi-Fi call XMPP account 3G/4G call The Android Menu icon, Back icon, Home icon and Search icon are icons (buttons) that are part of the Android device and may have a different appearance and location on different Android devices. A call made using the Bria screen. Compare to “native call”.
CounterPath Corporation 50