Bria iPhone 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 iPhone Edition ...........................................................................................................1 Configuring ...................................................................................................................................3 Device Requirements ..............................................................................................................3 Getting Ready .............................................................................
CounterPath Corporation ii
Bria iPhone Edition User Guide 1 About Bria iPhone Edition Bria iPhone Edition is a SIP-based phone for the Apple iPhone™ mobile digital device, and iPod touch™ mobile digital device. With Bria iPhone Edition (Bria), you can use the Wi-Fi internet connection on your iPhone, or iPod touch to make and receive calls without using mobile data. In addition, with iPhone (but not with iPod touch), you can use the mobile data connection for phone calls when you are not in a Wi-Fi zone.
CounterPath Corporation • • 2 Headset with microphone (including Bluetooth™): Bria iPhone Edition uses the ear-piece and microphone on the headset. Headphones (no microphone): Bria iPhone Edition uses the ear-piece on the headphone and the built-in microphone on the device.
Bria iPhone Edition User Guide 2 Configuring 2.1 Device Requirements To check your operating system, on the device Home screen, tap Settings > General > About and look for the Version. Audio Calls and IM/Presence Requirements Your device must run on iOS 4.3 or higher. For best performance, we recommend the newer generation of devices: iPhone 3GS and newer, and iPod 3rd generation or newer.
CounterPath Corporation 2.2 Getting Ready 1. Once you have installed Bria iPhone Edition, make sure you have set up Wi-Fi and mobile data correctly on your device: • • Set up Wi-Fi: from the main iPhone screen, tap Settings > Wi-Fi. Turn on the Wi-Fi field. The panel will be populated with access points. Tap to choose an access point and wait for the item to show a checkmark (indicating that you are connected).
Bria iPhone Edition User Guide 2.3 Setting up Bria To use Bria as a phone, you need to create a SIP account with the information provided by your VoIP service provider. Tap + Presence and IM is a premium feature. See page 7 for details. Select your VoIP service provider, if it is on the list. Otherwise, select Userdefined SIP Account. Complete the User Details section and Voice Mail section (optional) with the information provided by your service provider. Tap Enabled. The account is registered.
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 Account status Set up the account in the usual way Tap Save The Accounts screen reappears Both accounts are enabled and registered Account Status Status Meaning The account can be used to make and receive phone calls; see page 13. The account can only be used to make phone calls; see page 13. The account is disabled.
Bria iPhone Edition User Guide 2.4 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 Tap + Tap XMPP Account status Complete the User Details section with the information provided by your service provider. Tap Enabled. The account is connected. Tap Save. Tap Contacts > Buddies to see who is online. To add a new buddy, see page 31. Account Status Status Meaning The account is connected to an XMPP server, and can be used to send and receive instant messages; see page 27. The account is disabled.
Bria iPhone 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 31). 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 5), then follow the steps below. Tap Settings > Preferences. Tap to enable. Tap Settings > Accounts, and tap your SIP account.
CounterPath Corporation 10
Bria iPhone Edition User Guide 3 Making Phone Calls 3.1 Starting and Quitting Bria Start Bria. After a few seconds, the message “Phone Ready” appears. Bria is ready. 3G can be used only on devices that support 3G; see page 3. If your device does not support 3G, this message will never appear! This message appears if you did not enable mobile data (3G/4G) and you do not have a Wi-Fi connection. Use of moble data is optional; to turn it on go to Settings > User Preferences.
CounterPath Corporation 3.2 Placing a Call Using the Dialpad Clear the entire entry Enter the phone number Tap Backspace From the iPhone Contact List Tap the Contacts tab at the bottom of the screen 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 53. Search for the contact and tap it Tap the desired phone number A prompt appears for you to confirm the call. Or the call starts immediately.
Bria iPhone 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.
CounterPath Corporation 3.3 Handling Incoming Calls When Bria Is in the Foreground This is the account number; it appears only if you have more than one account enabled (page 6). It tells you which account the call is coming in on Tap Decline or Answer When Bria Is in the Background If you have an iPhone 3GS (or newer), or 3rd (or higher) generation iPod touch, you can run Bria in the background and still receive calls.
Bria iPhone Edition User Guide 3.4 Handling One Established Call Tap to show a keypad in order to enter numbers, for example, when choosing menu items such as “enter 1 for customer support” Mute or unmute Hold or release hold Speakerphone Tap to record (page 16) or transfer this call (page 19) Place a second phone call Handling a Bria Call and a Native Call Tap to return to the native call. The Bria will be put on hold Although there are two calls, only one is a Bria call.
CounterPath Corporation 3.5 Recording Calls Recording indicator You can pause recording by stopping recording and then starting again. Both recording sessions are saved in one file. Tap More, then tap Start Recording Tap More, then tap Stop Recording Recording also stops automatically when you end the call Listen to the recording on the History screen. Indicates this call was recorded Tap Tap You can also manage the recording in iTunes®.
Bria iPhone Edition User Guide 3.6 Placing a Second Bria Call Using the Dialpad Or tap here to go back to the first call Place the call on hold, if desired Tap Add Call Dial the number of the second person and tap Call When the call connects, the first call is put on hold. You are now speaking to the second person.
CounterPath Corporation 3.
Bria iPhone Edition User Guide 3.8 Unattended (Blind) Transfer You can transfer the current Bria call to a second person without first talking to that second person.
CounterPath Corporation 3.9 Attended Transfer You can speak to the second person first then transfer the first person to them. You know there are two calls established because the Swap Calls button is showing. Establish two calls (page 17) Tap More When ready, tap Transfer to. The live call is transfered to the on-hold call.
Bria iPhone Edition User Guide 3.10 Conference Call When you have two Bria calls established, you can merge the calls into a three-way conference call. Establish two calls (page 17) You know there are two calls established because the Swap Calls button is showing.
CounterPath Corporation 3.11 Handling Video Calls To use video on Bria, the Video Calls premium feature must be purchased (see page 50). Placing a Video Call Go to Contacts, and tap a softphone number. Tap to stop sending your video. Tap to switch to a rear camera. To hold, mute, or transfer, swipe the screen to the right. You Tap Video. Bria starts sending your video as soon as the other party accepts your video call.
Bria iPhone Edition User Guide Receiving a Video Call When the other party places a video call, you will see their video on Bria after you answer the call. • • You can start sending your video if desired by tapping the Send icon. If you do not want to receive the other party’s video during a call, swipe the screen to the right, and tap more > Remove Video. The call will be switched to an audio call. During a Video Call During a video call, you can: • • • transfer a video call.
CounterPath Corporation 3.12 Call History Tap the History icon at the bottom of the screen. Missed calls Tap to filter, as desired Incoming calls Outgoing calls Clearing the History Tap to clear the current view.
Bria iPhone Edition User Guide Creating a Contact from History You can create a contact from a history item. Tap the arrow icon The account the call came in on Tap Create New Contact or Add to Existing Contact If you tap Create, the New Contact screen appears with the number already entered. Complete the other fields. Or if you tap Add, the contact list appears. Tap the contact where you want to add this number. The contact is immediately updated.
CounterPath Corporation 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 calls established . The voicemail indicator on the iPhone home screen The voicemail indicator on the Bria screen Tap the voicemail icon; the voicemail number appears in the entry field. Place the call in the regular way. (If no number appears, you have not set it up in settings; see page 38.
Bria iPhone 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 cell 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. Tap Buddies and select a buddy. An XMPP account A SIP account Tap to send an IM. Type a message. Tap Send.
Bria iPhone Edition User Guide 4.2 Sending an SMS You can send an SMS from your SIP account to cell 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. Tap IM. Tap to select a number from the Contacts . Tap SMS. Tap a conversation. Or tap to enter a phone number or select a contact. Type a phone number. Type a message, and tap Send. By Selecting a Contact Tap Contacts.
CounterPath Corporation 4.3 Receiving an IM and SMS An alert comes up when you receive an IM or SMS. Tap. When Bria is in the background A new message appears on the top. Tap to see the message.
Bria iPhone 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 iPhone 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 tap it. Tap Edit. The person appears both in your Contacts and Buddies lists. Enter a softphone number, such as 1440. The domain name will be populated. Tap the arrow in im uri. Tap a softphone number, and tap Done.
Bria iPhone Edition User Guide Adding a new contact as a buddy Tap. Tap Buddies, then tap +. Select an SIP account if prompted. Enter a name and softphone number. Tap the arrow in im uri. Tap a softphone number, and tap Done. 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 iPhone 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. You have three options. • • • Accept: you let the other person see your online status. At the same time, the buddy request will be automatically sent from your Bria to this person, and you will see this person’s status in your buddies list. Decline: the person will not see your online status. You will not be bothered by the buddy request.
CounterPath Corporation 36
Bria iPhone Edition User Guide 5 Settings 37
CounterPath Corporation 5.1 Accounts All the fields on this screen must be supplied by your VoIP service provider. SIP Accounts To change these fields on an existing account, you must first unregister the account or turn Enabled off for the account. Top Half of Screen Bottom Half of Screen Field Description Account Name Change the name as desired. For example, “business account” Enabled Typically On, in order to use the account for calls. Display as Your name.
Bria iPhone Edition User Guide Account Specific Features Top Half of Screen Bottom Half of the Screen Field Description Enable Video ON to make video calls on this SIP account. To use this feature, you must purchase “Video Calls”, and enable video on Preferences . See page 50 for purchasing the feature. Always Offer Video ON to always dial a number with video offer. Whether you use the keypad, the Contacts tab, or the History tab, all the outgoing calls will offer video to the other party.
CounterPath Corporation Account Advanced (SIP) Top of Screen Middle of Screen Bottom of the Screen Field Description Out. 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. Auth Name May not be required. But if it is required, it will be provided by your VoIP service provider.
Bria iPhone Edition User Guide Field Description Encrypt Audio If the transport is set to TLS, you can encrypt a phone call at the media (audio) level: • Never: Audio is not encrypted. • If Possible: On a given call, audio will be encrypted if the other person supports and is also using audio encryption. If not, audio will not be encrypted. • Always: Audio will always be encrypted. The call will fail if the other person cannot accept encrypted calls.
CounterPath Corporation Field Description Username The XMPP user ID. Password Password for the XMPP user ID. Domain Domain of the XMPP service. For example, “gmail.com”. Account Advanced See below. Account Advanced (XMPP) Field Description Out. Proxy If your XMPP 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.
Bria iPhone Edition User Guide 5.2 Preferences Top of the Screen Middle of Screen Middle of the Screen Bottom of the Screen Field Description Allow 3G Calls • ON: When a Wi-Fi connection is not available, Bria will attempt to place calls using the mobile data channel. Data charges with your mobile carrier will apply. If you turn this setting on, we recommend you purchase the G.729 codec (page 50) because it provides better audio quality on 3G calls.
CounterPath Corporation Field Description Play Ringtone ON to hear the ringtone. Vibrate ON to vibrate when you receive a call. Alert Answer Controls the behavior of the incoming VoIP call prompt (when Bria is in the background): • ON: You can immediately answer the incoming call. • OFF: You can view the incoming call screen, and then choose either answer or decline the call.
Bria iPhone 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 Top of Screen Middle of Screen If you make changes to the fields identified by a bottom of the screen or restart Bria. Bottom of Screen , you must tap the Apply Changes button at the Field Description Network Traversal Strategy Tap to display the choices; see below. Use VPN If Active If you are using Bria with a VPN connection to your network, set this field to ON, to force Bria to select the VPN network interface.
Bria iPhone Edition User Guide Field Description Support RPort • On: the outgoing INVITE message will have an RPort parameter inside the Via header, which indicates that Bria supports RFC 3581. If the server also supports RFC 3581, the server should respond with the RPort parameter set to the incoming public IP port and the received parameter set to the public IP address. This is the default behavior in previous Bria versions. • Off: Bria does not have the RPort parameter in the Via header.
CounterPath Corporation Network Traversal Strategy Select a profile: • Default Configuration: STUN ON, ICE OFF, DNS SRV ON. Bria will use the STUN server at stun.counterpath.com to discover the public address of your device. It will present that public address for SIP signaling and when negotiating media routing. • Application Managed: STUN ON, ICE ON, DNS SRV ON. Bria will use the STUN server at stun.counterpath.com to discover the public address of your device.
Bria iPhone Edition User Guide Audio Codecs Selection You can only enable this codec if you have purchased it; see page 50. Drag the codec up or down to change its priority in the list. See below. Cell Audio Codecs Wi-Fi Audio Codecs These two screens list the audio codecs that can be used during a Wi-Fi call or mobile data 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.
CounterPath Corporation 5.4 Premium Features To purchase an item, tap the item. On the Product Detail screen, tap the price button to connect to the iTunes store. A confirmation prompt appears. Tap Cancel or Buy. 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 3G/4G because it provides better audio quality on your mobile data connection.
Bria iPhone Edition User Guide A Troubleshooting Using Bria Diagnostics If you have a problem with Bria, customer support may ask you to turn on diagnostics to capture information. 1. Go to Settings > Advanced Settings. If Verbose Logging is OFF, turn it to ON and tap Apply Changes. 2. Reproduce the problem. When done, go to Settings > Advanced Settings again. Tap Send Log. A prompt appears. The e-mail opens in the e-mail service that you have configured on your iPhone.
CounterPath Corporation • Whether you normally have 3G/4G enabled on your device and in Bria. 4. When done, turn off Verbose Logging. Tap Apply Changes. More Information • • 52 You can view Frequently Asked Questions at https://support.counterpath.com/default.asp?W367. You can visit the Bria iPhone Edition forum at forums.counterpath.com > Bria iPhone Edition.
Bria iPhone 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 dial plan to change any number that starts with “+1613” to just “613”. Setting up Dial Plans You can create as many dial plans for an account as you need. A dial plan belongs only to one account. Bria goes through the dial plans in the order in which they appear on the screen.
CounterPath Corporation Designing the 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: removing a prefix, adding a prefix, or removing one prefix and adding another one. Subsequence substitution is also supported. 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.
Bria iPhone Edition User Guide Advanced Dial Plan: Subsequence Substitution The match pattern can include a sequence of numbers to match and another sequence to substitute for the match. This feature is useful if you want to convert a sequence within the input, not just add or remove a prefix. The syntax is: For example: <604:250> means change the sequence “604” to “250”. The sequence substitution element can be combined with any other elements in the match pattern.
CounterPath Corporation 56
Bria iPhone Edition User Guide C 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 Wi-Fi call XMPP account 3G/4G call A call made using the Bria screen. Compare to “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.
CounterPath Corporation 58
