Bria 3.
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 © January 2010 CounterPath Corporation. All rights reserved. Mac, Mac OS, QuickTime and iSight are registered trademarks of Apple Inc., registered in the U.S.
Contents Introduction...................................................................................................................................1 Installation and Setup....................................................................................................................3 Getting Ready .........................................................................................................................3 Starting Bria ...................................................................
CounterPath Corporation 2
1 Introduction Read this manual if you who are working in an enterprise and your system administrator. It is assumed that your system administrator has either configured Bria on your behalf or has give you instructions on configuring it yourself. If you are not working in an enterprise, read the user guide “Using Bria for Mac – for Retail Deployments”.
CounterPath Corporation • • • • 2 Automatic selection of the best codec based on the other party’s capability, the available bandwidth, and network conditions. Bria switches the codec within a call in response to changing network conditions. Compliance to 3261 SIP standard. XMPP compliance as follows: • RFC 3920 • RFC 3921 Supported extensions: • XEP-0004 • XEP-0016 • XEP-0022 • XEP-0077 • XEP-0085 • XEP-0092 • XEP-0115 Support for these firewall traversal solutions: STUN, TURN, or ICE.
2 Installation and Setup 2.1 Getting Ready Multimedia Device Requirements Bria requires both speakers and a microphone to make calls. Any of the following configurations are acceptable: • • • • • External speakers and microphone Built-in speakers and microphone Dual-jack multimedia headset USB multimedia headset USB phone. Bria is optimized to work with Apple iSight camera.
CounterPath Corporation 2.2 Starting Bria First-time Startup If Bria is not already running, start it as you would any other program. The Bria Login dialog appears with the Profile set to “Manually configure login server”. 1. Set the profile to the value specified by your system administrator and click Continue (or Log in). Typically: • • 2. No login required: Used if you will manually configure Bria, as described below.
Bria 3.0 for Mac User Guide – Enterprise Deployments 2.3 Configuring Bria Read this section if your system administrator advises you that you must either configure Bria or complete the configuration. (If your administrator advises you that configuration is already done, go to “Setting up a Contact List” on page 6.) 1. From the menu, choose Bria Beta > Preferences then click on Accounts. The Accounts window appears with fields for Account 1 (a SIP account) on the right-hand side. 2.
CounterPath Corporation 2.4 Setting up a Contact List Typically, you will want to create contacts in order to easily make phone calls, send IMs and transfer files. You can set up contacts in several ways: • • • During a call that you place or receive, you can add the other party to your contact list. See “Handling an Established Call” on page 16. You can add addresses to the Contact list one by one. See page 16. You can use your Mac address book directly from Bria. See page 30.
Bria 3.0 for Mac User Guide – Enterprise Deployments 2.6 Checking for Bria Updates Your system administrator should tell you about the policy for checking for and installing upgrades. To check for updates to Bria, choose Help > Check for updates. The Auto Update window appears. • • If a new version of the software is available, you can download it from this window. If no newer version is available, this window informs you that your version is up to date.
CounterPath Corporation 8
3 Using Bria 3.1 The Onscreen Softphone Minimize to dock Close window Open/close video window Call entry field See page 11. Show/hide dial pad Hide each resources tabs Resources.
CounterPath Corporation The Bria Menu The menu contains the following items that are specific to Bria: • • • • • Bria > Preferences.You will work with these settings only if advised to do so by your system administrator. View. Changes how Bria looks, and shows and hides specific modules. Contacts. Lets you work with contacts. Action. Lists the actions that you can perform, depending on the current “state” of Bria.
Using Bria 3.0 for Mac – Enterprise Deployments 3.2 Placing a Call You can contact someone using: • • A traditional phone number, if supported by your VoIP service provider. A softphone address (for example, kperera@domainA.com) You can place one more call when another call is already in progress. There is no limit to the number of calls you can make, although eventually the quality of audio and video will degrade because of limitations on the computer. We recommend no more than six concurrent calls.
CounterPath Corporation Call entry field Click to place the call Auto complete suggestions 12
Using Bria 3.0 for Mac – Enterprise Deployments Placing another Call To place a new call (without hanging up on the current call), simply place the call in the normal way. A second call panel opens below the current call. The first call is automatically put on hold. Switch between the different calls by clicking Resume on the desired call panel. That call becomes the active call and all other calls are on hold.
CounterPath Corporation 3.3 Handling Incoming Calls Bria must be running to answer incoming calls. (If Bria is not running, incoming calls may be directed to voicemail; check with your VoIP service provider check with your system administrator.) As soon as an incoming call is received, a call panel appears, showing information about the call. In addition, the Call Alert box appears, even if Bria is minimized. For information on call alerts, see page 42. Action Answer From the...
Using Bria 3.0 for Mac – Enterprise Deployments Auto Answer You can set Bria to automatically answer all incoming calls. To turn auto answer off and on, in the Call panel click Options > Auto Answer. The AA icon appears in the menu bar. Turn Auto Answer on or off The Auto Answer indicator appears on the menu bar. Auto answer is initially configured to auto-answer after one ring, and to send only your audio when the call is established. You can change this configuration; see page 47.
CounterPath Corporation 3.4 Handling an Established Call While the call is in progress you can: • • • • • • Control the audio: use the speakerphone, mute the call, control volume. Record the call. Put the call on hold. Add the caller as a contact. Transfer the call. See the next page. Add video. Pause and resume video when video is already present. See “Handling Video Calls” on page 19. Place another call (current call is automatically put on hold).
Using Bria 3.0 for Mac – Enterprise Deployments 3.5 Transfering a Call Basic (Unattended) Transfer – Transfer this Call You can transfer a call to any number without first speaking to the other person. Click the Transfer button The call is put on hold and a call entry field appears. Type a name or number, or drag a contact into the field. Then click Transfer Now The call may end immediately.
CounterPath Corporation Attended Transfer – Call then Transfer You can first speak to the target (the person you are transfering the call to), then click Transfer to complete the transfer.
Using Bria 3.0 for Mac – Enterprise Deployments 3.6 Handling Video Calls Click the down arrow and choose Video call Show/hide dialpad Call entry field Placing a Video Call You can start a call with video. See the table. How Keying From the... Dialpad or computer keyboard Description 1. Enter the number or address in the call entry field using the dialpad or the computer keyboard. If entering a softphone address, you can enter the entire address (kperera@domainA.com) or just the name (kperera).
CounterPath Corporation Adding Video If you have a camera, you can click Start Video to add video to an established call. When you add video, the other party may (or may not) start sending their video to you. Other Party Adds Video If the other party starts their video, your video panel automatically opens and the video is played. You can start sending your own video, if desired (and assuming you have a camera) by clicking Start Video on the call panel.
Using Bria 3.0 for Mac – Enterprise Deployments 3.
CounterPath Corporation Managing the Conference Mute. When you mute during a video call, you may also want to click Stop Video to stop the video feed. Participant menu Conference call entry field Adding More Participants You can add more participants to an existing conference in any of these ways: • • • Control-click on a contact and choose Add to Conference Call. In the conference call panel, enter a name in the call entry field and click Add.
Using Bria 3.0 for Mac – Enterprise Deployments Video Conference Calls This person already has video. This person does not have video. To add this person to the group who will receive video, choose Start video from the participant menu. Closing the video window stops sending video to all participants who have “Video” beside their name.
CounterPath Corporation 3.8 Voicemail If your service includes voicemail and you have set up voicemail options (page 39), then when you have voicemail messages, the voicemail icon appears at the top of the phone (the icon may include a number). You can click the icon to automatically connect to voicemail and listen to your messages. Voicemail icon 3.9 Forwarding Calls You can enable or disable forwarding so that calls will be forwarded to another number.
Using Bria 3.0 for Mac – Enterprise Deployments 3.10 Instant Messaging Sending an IM 1. There are several ways to select the person to send an IM to. From the Contacts tab Control-click on the contact and choose Send IM. The contact must have a softphone address. An active phone call If the person is a contact, choose Send Instant Message from the call panel menu. An active conference call If the participant is a contact, choose Send Instant Message from the participant menu. 2. Type the message.
CounterPath Corporation Conference IM—Group Chat Group chat allows you to exchange instant messages with a group of people in the same session. All people must have XMPP accounts configured in order to participate in group chat. There is no limit to the number of participants in a group chat. You can also invite more participants during a group chat session. 1. In the Address Book on the Contacts tab, select the desired contacts. Contacts must be online. 2.
Using Bria 3.0 for Mac – Enterprise Deployments Viewing the IM Archive You can view your recent IM activity for any contact or group chat session. On the menu, choose View > Instant Message Archive. In the Archive window, select a contact from the list.
CounterPath Corporation 3.11 Sending and Receiving Files Sending Files If you have an XMPP account, you can send files to another contact who has a Jabber address (meaning that they have an XMPP account). 1. Right-click a contact and choose Send Files; a standard Open dialog box opens. 2. Select the files to send and click Open. The Send Files dialog appears with a “waiting” message. If you want, you can cancel the send before the other person retrieves the file.
4 Using the Resources 4.1 Contacts Tab Add a Contact Filter and sort options Search field The online status of others. See page 34. The Contacts tab displays your contacts and lets you specify multiple contact methods for them, including: • • Softphone address Home phone number, business phone number, mobile phone number Contacts are typically organized into groups. Bria includes built-in groups: “Family”, “Friends” and “Work”. You can add more groups, as desired.
CounterPath Corporation Populating the Contact List At any time, but particularly when you first deploy Bria, you may want to populate the contact list with contacts from an external source. From WebDAV or XCAP If your system administrator has set up a WebDAV or XCAP server, then once Bria is configured to use this server for contact storage, the contacts from that source will automatically appear in the contact list. From then on, each time you add a contact, it will be stored on that server.
Using Bria 3.0 for Mac – Enterprise Deployments Field Description Contact name Only the “Display as” name is required. This is the name that will appear in the call panel and the Call Alert when this person phones you. Group Click to show the list of groups and check each group to add this contact to. See presence This box becomes enabled only if you have entered a softphone or Jabber address. If you check this box, you will share your online status with this person; see page 34.
CounterPath Corporation Using Contacts Phone the person Control-click and choose Call, then click the desired number. Send an IM Control-click and choose Send IM. See page 36. Start a Group Chat session Right-click and choose Start Group Chat. See page 26 You can watch the contact’s online status, if the contact has a softphone address See page 36 for the meaning of the online status icons. See “Sharing Online Status” on page 34 for information on obtaining online status information.
Using Bria 3.0 for Mac – Enterprise Deployments 4.2 History Tab Incoming missed call Outgoing call, either attempted or established Incoming call that was answered Managing the List You can control-click on an entry in a list to: • • • • Delete the call. Delete all entries in this list. Edit the profile if the entry is a contact. Add as contact. The Contact dialog appears. For more information on this dialog, see “Adding a Contact using an Existing Address” on page 31.
CounterPath Corporation 4.3 Sharing Online Status You can publish your online status to contacts who have softphone address, and you can set up Bria to view the online status of other contacts. Typical online statuses are available, on the phone, busy, and so on.
Using Bria 3.0 for Mac – Enterprise Deployments Setting the Presence Account Online status information (presence) is always handled through the XMPP account (if you have one). If you do not have an XMPP account, it is handled through one of the SIP accounts; see the Accounts window. Do not change the account that is used for presence unless instructed to do so by your system administrator.
CounterPath Corporation Setting your Online Status Changing your Status Click the down arrow beside the online status indicator on Bria, and select the desired value. See the table below. When your online status changes, the new status is sent to everyone who has permission to see your status. Setting up Online Status Indicators You can create a custom status indicator: click the down arrow beside the status indicator, and choose Custom Message.
Using Bria 3.0 for Mac – Enterprise Deployments Indicator Meaning for your Status Meaning for Others’ Status Offline You have set your status to this value. The other person sees you as offline, even though you are not actually offline. The other person cannot tell the difference between this status and you really being offline. The contact is either not logged on or else is not set up to shared online status information. No icon Not applicable You are not watching the other person’s online status.
CounterPath Corporation 38
5 Configuring Bria Choose Bria > Preferences. The Preferences window appears. • • When configuring Bria the first time, click the Accounts tab and set up the account. Then complete other tabs as desired. After the initial setup, display whichever tab you want. 5.1 Configuring Accounts In general, you will work with the Account Settings window only when advised to do so by your system administrator. The only feature that you might set up on your own is call forwarding: 1.
CounterPath Corporation • Always forward to this address: To always forward phone calls, click the box and enter the address to forward to. Phone calls received on other accounts (if you have them) are not affected by enabling this field. Always forward works only when Bria is running. • When on the phone, forward to: To forward only when you are on another phone call, click the box and enter the address to forward to.
Using Bria 3.0 for Mac – Enterprise Deployments 5.2 General Preferences Choose Bria > Preferences. The Application window appears. All the tabs on this window except for “Accounts” are preferences tabs. These tabs let you control the way that you work with Bria. Preferences – Application This panel lets you set your preferences for general GUI behavior and lets you set up for login.
CounterPath Corporation Preferences – Alerts & Sounds This panel lets you control the alert box and lets you assign sounds. Enable Alert Displays You can control whether the Call Alert box is displayed in different situations. You can also control how you are alerted to an incoming IM: either with a small IM Alert box or with the IM window itself. Assigning Sounds You can assign specific sounds to a variety of actions or “events”. 1.
Using Bria 3.0 for Mac – Enterprise Deployments Preferences – Devices Bria automatically detects devices at each startup, and selects the most appropriate device for each purpose. If you do not like this selection, you can override it on this panel. If you override a selection, it will apply the next time you start Bria, unless the device is no longer available, in which case Bria will again select the device to use.
CounterPath Corporation Field Description Headset Mode Speaker Change these fields only if you want to override the devices that Bria automatically selected. Microphone In both these fields, select the headset you are using. The headset is the device that is usually used for audio out (the sound you hear) and audio in (recording your voice). The only situation in which the headset is not used is when the Speaker Phone button on the dialpad is pressed.
Using Bria 3.0 for Mac – Enterprise Deployments Preferences – Network Field Network Connection Speed Description Select the type of network connection for your computer. The sliders move to show the bitrate that will be used for sending and receiving. These rates are typical rates for the selected configuration. If you know that your computer and network can handle a faster sending speed, click Custom and move the slider. It is recommended that you not change the receiving speed.
CounterPath Corporation Preferences – Video Codecs Change the settings on this tab only if advised to do so by your system administrator.
Using Bria 3.0 for Mac – Enterprise Deployments Preferences – Call Automation These settings let you configure how you want auto answer to handle incoming calls, when Auto Answer is enabled. (To enable Auto Answer, see page 20). Preferences – Contact Storage Change the settings on this tab only if advised to do so by your system administrator.
CounterPath Corporation Preferences – Advanced Field Description Audio Reduce device echo Turning this feature on improves sound quality. This feature is typically on. Reduce background noise Automatically attempts to remove background noise. Typically on for the speakerphone. Automatic gain control This feature is typically on. Use slower but more compatible video format Turning this field on may improve performance when running Bria on older hardware.
A Troubleshooting Choose Help > Troubleshooting to display the Troubleshooting window. Testing Audio Devices You can verify that your microphone and speakers are working and can set the volume to a comfortable level without having to actually place a phone call. F Testing the Network Connection You can verify that you are successfully connected to the network.
CounterPath Corporation Testing Audio Quality While you are on a phone call, you can test the quality of the audio. Note that to perform a valid test, you should be on an established call (not a call attempt). Diagnostics Only use this panel if instructed to do so by your support representative at your VoIP service provider.
Using Bria 3.0 for Mac – Enterprise Deployments B Glossary AEC AGC Broadband Codec Dial plan DTMF IM IP IP address Media MOV MWI Narrowband Presence Proxy PSTN RFC RTP Signaling Acoustic echo cancellation. Processing of the audio or video signal to reduce the echo effect that can arise with a speakerphone or that can arise if the sound from the speakerphone or headphone leaks into the microphone. Automatic gain control.
CounterPath Corporation SIMPLE protocol SIP SIP account softphone address SRTP TCP TLS UDP URI URL USB device VAD VoIP VoIP service provider WAV 52 controlling the connection, and managing the network. The non-signaling portion of the call is the Media. Session Initiation Protocol for Instant Messaging and Presence Leveraging Extensions. The instant messaging (IM) protocol followed by Bria. It encapsulate the rules for exchanging instant messages. Session Initiation Protocol.