Bria Android Tablet 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 © 2014 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 Tablet Edition ..............................................................................................1 Configuring Bria ...........................................................................................................................3 Getting Ready .........................................................................................................................3 Setting up ...................................................................................
CounterPath Corporation ii
Bria Android Tablet Edition User Guide 1 About Bria Android Tablet Edition Bria Android Tablet Edition is a SIP-based phone for an Android tablet. With Bria Android Tablet Edition (Bria), you can use the Wi-Fi internet connection on your Android tablet 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 Operating System Your device must run on Android V3.2 or later. Accessories The following accessories are supported: • • 2 Headset with microphone (including Bluetooth™): Bria uses the ear-piece and microphone on the headset. Headphones (no microphone): Bria uses the ear-piece on the headphone and the built-in microphone on the Android tablet.
Bria Android Tablet Edition User Guide 2 Configuring Bria 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 1. Set up Wi-Fi connection.
CounterPath Corporation 2.2 Setting up Tap the icon. The Accounts screen appears. Tap Add Account. Select your VoIP Provider on the list. Otherwise select Generic SIP. Complete the User Details section and Voice Mail section (optional) with the information provided by your service provider. When done, tap the Back button. Then wait for the account to register. When you have successfully registered, tap the Back key. Tap the keypad icon.
Bria Android Tablet Edition User Guide Account Status Status Meaning The account is in the process of registering. The account is enabled and registered for incoming and outgoing calls. The account is enabled only for outgoing calls. (Accounts > Account Advanced > Incoming Calls is turned off.) The account is disabled. You can enable it; it will then automatically register. The account is enabled but registration failed. Check that you entered your account credentials correctly.
CounterPath Corporation 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 15). There are two ways to change the account: On the Main screen, tap @ and choose the dial-out account you want to use. 6 On the Accounts screen, long-tap the account you want to use for the dial-out account, and tap Set as Primary Account.
Bria Android Tablet 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 Settings > Accounts. Tap Add Account Tap Facebook chat, Google, or XMPP. Complete the User Details section Account status Tap the Back key to go back to the Account page. Make sure that the account shows a checkmark. Tap the Back key to go back to the main panel. Tap Contacts > Buddies to see who is online. To add a new buddy, see page 41. Account Status Status Meaning The account is in the process of registering.
Bria Android Tablet 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 41). 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 Settings > Accounts. Unregister your SIP account to make changes, and then tap the account.
CounterPath Corporation 2.4 Widget Bria has a widget which allows you quick access to each tab of Bria such as: Dial Pad, Contacts, History, Messages and Settings. The widget does not show a badge for unread messages or missed calls. To add the widget to the home screen, go to the widgets library on your device, look for Bria, hold down the Bria icon and drop it on to the Home screen. Hold down the icon.
Bria Android Tablet Edition User Guide 2.5 Adding Facebook Friends On Bria, you can merge Facebook friends in the contacts list. After the merge, Bria’s contact detail page will show the latest status of your friends posted on Facebook. Go to Settings > Accounts. Tap to turn on Facebook Connect. Log in to Facebook if prompted. To remove Facebook friends from the contact list, turn it off. Tap OK to give Bria a permission to access your Facebook account. This pop-up appears only once.
CounterPath Corporation 12
Bria Android Tablet Edition User Guide 3 Making Phone Calls 3.1 Starting and Quitting Bria Tap the Bria icon to start Bria. After a few seconds, the Bria screen appears. Default dial-out account Opens the Settings screen Opens dialpad The contacts tab is automatically populated with contacts from your Android native contact list. Bria’s contacts are continually synchronized with your native contacts; adding, modifying or deleting a contact from one list updates the other list.
CounterPath Corporation 3.2 Placing a Bria Call You can place a Bria call unless you are already o n a native call or already on two Bria calls. Using the Dialpad Tap the dialpad icon, and enter the phone number. To enter letters and symbols, tap on the call field; the keyboard appears. Tap Backspace From the Bria Contact List Tap the Contacts tab, and search for the contact .
Bria Android Tablet Edition User Guide The “Network Quality Issues“ Message This message appears if there is network congestion or a poor quality Wi-Fi signal. Try moving closer to your Wi-Fi access point. 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. On the keypad: Dial a phone number, long-tap the call button, and tap the account you want to use.
CounterPath Corporation 3.3 Handling Incoming Calls 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.
Bria Android Tablet Edition User Guide 3.4 Handling One Established Call Call in Foreground Mute or unmute the active call Enable or disable Speakerphone for the active call, or choose other audio output options if connected. To use a bluetooth device, Use Bluetooth under Preferences must be turned on. Record the active call Video call Tap to show a keypad in order to enter numbers, for example, when choosing menu items such as “enter 1 for customer support”.
CounterPath Corporation Call in Background (Minimized) You can still work with the calls in this mode. Mute or unmute the active call 18 Enable or disable Speakerphone for the active call Tap the bar to go back to the in-call screen.
Bria Android Tablet Edition User Guide 3.5 Recording Calls Tap Record You can pause recording by stopping recording and then starting again. Both recording sessions are saved in one file. Recording also stops automatically when you end the call You can listen to the recording on the History screen on Bria. You can also access the recorded files using a file explorer or a file manager. The recording is saved in the WAV format under the /sdcard/Bria folder of the device.
CounterPath Corporation Go to History tab. The red dot indicates the call was recorded. Tap the Play icon to listen to the recording. Bria launches a media player on the device.
Bria Android Tablet Edition User Guide 3.6 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 History. Using the Dialpad Place the call on hold first, if desired Tap Add call Dial the number of the second person Tap the phone icon. 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 From the Contact List Place the call on hold first, if desired Tap anywhere outside of controls or tap the back button to leave the in-call screen. Tap the Contacts tab and search for a contact. Tap to call. The second call is dialed. From the History Place the call on hold first, if desired Tap anywhere outside of controls or tap the back button to leave the incall screen. Tap the History tab Tap to call. The second call is dialed.
Bria Android Tablet Edition User Guide 3.7 Handling Two Established Calls Two Bria Calls in Foreground Switches to the other person. Two Bria Calls in Background (Minimized) You can access the Contacts or History tab as well as the Settings screen without putting your call on hold. Mute and Speaker are available at the top. Tap either bar to go back to the call screen.
CounterPath Corporation 3.8 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 Transfer. The keypad appears. Dial the number of the person to transfer to Tap the arrow icon. 24 A call is placed to the transferee, and ends on your side.
Bria Android Tablet Edition User Guide From the Contact List Place the call on hold first, if desired Tap anywhere outside of controls or tap the back button to leave the in-call screen. Tap the Contacts tab and search for a contact. Tap to call. The second call is dialed. From the History Place the call on hold first, if desired Tap anywhere outside of controls or tap the back button to leave the incall screen. Tap the History tab Tap to call. The second call is dialed.
CounterPath Corporation 26
Bria Android Tablet Edition User Guide 3.9 Attended Transfer You can speak to the second person first then transfer the first person to them. Establish two calls (page 21) It does not matter which call is live and which is on hold A message appears, and both calls end on your side. Tap Transfer 3.10 Conference Call When you have two Bria calls established, you can merge the calls into a three-way conference call. Tapping End Call ends the conference and hangs up on both calls.
CounterPath Corporation 3.11 History Tap the History tab. Tap to filter, if desired. Incoming call that was answered Missed incoming call Outgoing call Adding a Contact from the History Tap the desired item Tap Save. The contact is saved on your native contacts as well.
Bria Android Tablet Edition User Guide 3.12 Handling Video Calls To use video on Bria, the Video Calls premium feature must be purchased (see page 63). Placing a Video Call Go to Contacts, and tap Video icon beside a softphone number. Bria starts sending your video as soon as the other party accepts your video call. Tap to remove video from both ways. The call is back to audio-only. Tap to stop sending your video. You will still see video of the remote party.
CounterPath Corporation During an Audio Call, tap the video icon to add video. Bria starts sending your video. To remove video from both ways, tap the video icon. The call goes back to an audio call. Tap to stop sending your video. You will still be able to see the other party’s video when the other party is ready. Receiving a Video Call When the other party places a video call, you will see their video on Bria after you answer the call.
Bria Android Tablet Edition User Guide 3.13 Accessing Voicemail If your VoIP service provider provides a voicemail service, then incoming calls go to voicemail if: • • Bria is not running. You already have two Bria calls established. The voicemail indicator Swipe up to open notification center. There are two ways to access voice mail: Tap the voicemail icon on the top bar, and then tap Call Voice Mail. Or Tap the Keypad icon, and then tap the vm icon.
CounterPath Corporation 32
Bria Android Tablet Edition User Guide 4 Presence and Instant Messaging With Presence and 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 service supports this feature (ask your VoIP service provider). Presence and Messaging is available as an in-app purchase.
CounterPath Corporation 4.1 Sending an IM You can send an instant message to your buddy. If you have no buddies, add someone as a buddy first (page 41). Tap the Messages tab, and then tap IM and Presence. Tap a conversation or tap the + icon to select a buddy. Canned messages. Select a buddy. Type a message. Tap the icon to send. You can also call this person if this person provides a phone number. SIP is used to make calls.
Bria Android Tablet Edition User Guide By Selecting a Contact Tap the Contacts tab, and then tap Buddies. Choose a buddy to send IM. Tap Send Instant Message. If it is a SIP buddy, tap Message icon beside a number. Type a message. Tap the icon key to send.
CounterPath Corporation 4.2 Sending an SMS You can send an SMS from your SIP account to mobile phone numbers if your service supports this feature (ask your VoIP service provider). Before sending an SMS, make sure SMS is enabled (ON) on Preferences and on your SIP account. Tap the Messages tab, and then tap SMS. Tap a conversation or tap the + icon to open a new SMS screen. Type a name of your contact. Bria suggests numbers that match what’s entered. Type a message. Tap the icon to send.
Bria Android Tablet Edition User Guide By Selecting a Contact Tap the Contacts tab. Search for and tap the contact. Tap SMS. This icon is for sending IM. Type a message, and tap the icon to send.
CounterPath Corporation 4.3 Receiving an IM and SMS An alert comes up when you receive an IM or SMS. .Tap the notification icon. Or swipe up to open notification center, and tap the desired option. Tap the Message tab.
Bria Android Tablet Edition User Guide 4.4 Starting 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 the app cannot join a group chat. All the users must connect to the same XMPP server; in other words their XMPP accounts must have the same domain.
CounterPath Corporation Starting a Group Chat You can invite up to 10 XMPP buddies; 11 people maximum in one chat including you. • • Buddies must be online (registered to the XMPP server); if their accounts are unregistered, they will not receive your invitation and therefore cannot join the group chat. Once a group chat is held with participants, you cannot remove some of the participants. Tap Messaging, then IM. Tap the icon to select a buddy. Tap + to add more buddies.
Bria Android Tablet Edition User Guide 4.5 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 tablet contacts.
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 Contacts, and search for the contact. Tap Edit. Change the phone type to Softphone. Tap Presence and IM. Tap a softphone number. The domain is automatically populated. Tap Save. The person appears both in your Contacts and Buddies lists.
Bria Android Tablet Edition User Guide Adding a new contact as a buddy Tap Contacts > Buddies, and tap the + icon. Tap SIP buddy. Tap to change this to Softphone. Enter a softphone number. Tap Presence and IM. Tap a softphone number. The domain name will be populated. Tap Save. The person appears both in your Contacts and Buddies lists.
CounterPath Corporation 4.6 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 Tablet Edition User Guide 4.7 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 46
Bria Android Tablet Edition User Guide 5 Settings On the Main screen, tap the Settings icon. To go back to the main screen, tap the Back button. • • • • • Accounts: See page 48. Preferences: See page 55. Advanced Settings: See page 58. Premium Features: See page 63. Share feature: See page 64.
CounterPath Corporation 5.1 Accounts 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” **do bfc version ()read only) Display As Your name. Other people may see this as the caller ID (or they may see just your phone number).
Bria Android Tablet Edition User Guide Account Specific Features (SIP) Field Description Disable Mobile Data If you have multiple accounts and want to use mobile data only on some of the accounts, turn this setting on for the account you do not want to use data. This setting appears only when “Use When Available” is enabled under Preferences. • When ON, no mobile data will be used; this account does not register with SIP service when Bria is in the mobile network.
CounterPath Corporation Field Description Subscribe Refresh Interval for subscribing your buddy’s status over SIP SIMPLE. Value in seconds. Minimum 30, default 900. Enable SMS ON to send an SMS to PSTN cell phone numbers by using the SIP SIMPLE protocol. Turn ON if your service supports this feature (ask your VoIP service provider). The purchase of “Presence and Messaging” is required to use this feature.
Bria Android Tablet Edition User Guide Field Description Suppress STUN Wi-Fi Allows you to control the use of STUN per account. • On: No STUN is used on this particular account. This setting overrides the STUN Wi-Fi setting under Advanced Settings (which applies to all accounts); when Suppress STUN Wi-Fi is ON, no STUN is used on this particular account even if STUN is enabled under Advanced Settings.
CounterPath Corporation Field Description Single Register • On (checked): Bria will register using a single register request. • OFF: Bria will register using an unregister and a register. Only turn on if advised by your VoIP service provider. Connection Reuse • ON: Bria uses existing connections by including an “ob“ parameter in a header as defined in RFC5626. • OFF: Bria does not reuse existing connections. Changing this setting might solve problems with dropping or holding calls. The default is On.
Bria Android Tablet Edition User Guide XMPP Accounts Field Description Account Name Change the name as desired. For example, “Gmail”. Username The XMPP user ID. Password Password for the XMPP user ID. Domain Domain of the XMPP service. For example, “gmail.com”. Account Specific Features See below. Account Advanced See below.
CounterPath Corporation Account Advanced (XMPP) Field Description Outbound Proxy If your VoIP service provider has an outbound proxy and requires that you 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). Priority The priority of the resource. The range is from -128 to 127.
Bria Android Tablet Edition User Guide 5.2 Preferences Field Description Use When Available Appears only on the devices with mobile data connectivity. • On (checked): When a Wi-Fi connection is not available, Bria will attempt to connect to SIP/XMPP services using the mobile data network. Data charges with your mobile carrier will apply. You will be able to receive messages and voice mail notifications when Bria is in the mobile data network.
CounterPath Corporation Field Description Enable SMS On to enable SMS on Bria. Alert Sound ON to play a ringtone when you receive a new message. Alert Vibration ON to vibrate when you receive a new message. Alert Text Tone The ringtone for incoming messages. Custom Colors You can change the default color of Bria. Show URI Domain • On: The phone number displayed for an incoming, outgoing or established call will include the domain name (for example, 1234@myVoipProvider.com).
Bria Android Tablet Edition User Guide Field Description Video Quality • Automatic: Recommended. Let Bria select the best quality to use in a given situation. • Lower (QCIF): Quarter Common Intermediate Format uses 176 horizontal pixels and 144 vertical lines. QCIF transfers one fourth the amount of data; therefore it consumes less memory than CIF. • Higher (CIF): Common Intermediate Format uses 352 horizontal pixels and 288 vertical lines.
CounterPath Corporation 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 Network Traversal Strategy Tap to display the choices; see page 60. Use VPN If Active If you are using Bria with a VPN connection to your network, turn this field on, to force Bria to select the VPN network interface.
Bria Android Tablet Edition User Guide Field Description Echo Cancellation Try turning on this setting if you or the person you are talking to is hearing an echo. When you turn this on, you can also choose the echo cancellation mode. If the other person still hears an echo, turn this setting back to Off. Codecs Variable Bitrate This setting applies when the negotiated codec is AMR-WB, SILK, Opus or H.264 (for video call).
CounterPath Corporation Field Description Enable PRACK • On: Bria advertises that it supports “100rel” and allows PRACK, as defined in RFC 3262. The outgoing INVITE message will have “100rel” in the Supported header and “PRACK” in the Allow header. This is the default behavior in previous Bria versions. • Off: Bria will not advertise these features; there will be no “100rel” in the Supported header.
Bria Android Tablet 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 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. In general, it is desirable to have several codecs enabled. Make sure that there are common codecs between you and the remote peer, otherwise your call will fail with a 488 error. SILK-SuperWideband (24k) and Opus-Fullband (48k) are available only in devices with 1.2 GHz dual core CPU or higher.
Bria Android Tablet Edition User Guide 5.4 Premium Features Premium Features offer items that you can purchase to use on Bria. • G.729a codec is a narrowband audio codec that is intended for low bandwidth use. It is particularly recommended if you will be making calls over mobile network because it provides better audio quality on your mobile data connection. •AMR-WB codec is a wideband codec that provides superior sound quality due to a wider speech bandwidth.
CounterPath Corporation 5.5 Share You can share Bria with your friends via Facebook, Twitter, and Email. Bria will publish a post on your Facebook or Twitter page on your behalf, with a link to the Bria’s app page. To share on Twitter, make sure you have the official Twitter app installed on your device and already logged into the sites. For email, make sure you have an email account set up on OS. Open Bria, and go to Settings > Share, then choose how you want to share Bria.
Bria Android Tablet Edition User Guide Twitter Tap Type a message and tap Tweet to publish the post.
CounterPath Corporation A Troubleshooting More Information • • You can view Frequently Asked Questions at https://support.counterpath.com/knowledge-base/briaandroid-android-tablet-edition. You can send us comments from http://support.counterpath.com. 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 Settings > Advanced Settings and scroll down to the bottom. 2. Turn on Verbose Logging. 3.
Bria Android Tablet 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 eight 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 that the phone number (the input) must match. This corresponds to the Match Number field. The modification to make if the input matches that pattern: removing a prefix, adding a prefix, or removing one prefix and adding another one. The modification can add or remove characters and can be made up of digits, wildcards or symbols. These correspond to the Remove Prefix and Add Prefix fields.
Bria Android Tablet Edition User Guide C Glossary DTMF ICE IM IP address IVR Media PSTN Presence Signaling SIP SIP account softphone address STUN Wi-Fi call XMPP account Dual-tone multi frequency. DTMF is the system that is used in interactive voiceresponse menu systems such as the menu system for accessing voicemail messages. The DTMF system allows the user to interact with the menu by pressing keys on a dial pad or keyboard. Interactive Connectivity Establishment. A method for traversing a firewall.
CounterPath Corporation 70
