Help For Blink Pro

Version 22 (Tijmen de Mes, 06/25/2012 12:22 pm)

1 1 Tijmen de Mes
h1. Help for Blink Pro on MacOSX
2 1 Tijmen de Mes
3 2 Tijmen de Mes
Blink allows you to communicate in real time over the Internet. To use Blink you need a SIP account from a SIP service provider. Same like using an email program, you must configure Blink with the account you have obtained from your service provider. If things do not work they way you expect, the reasons can be caused mainly by two things, one is Blink software itself and the another one is the communication with the SIP Service Provider. 
4 2 Tijmen de Mes
5 2 Tijmen de Mes
While Blink may not be bug free, most of the problems you encounter when using Blink are related to the network communication with the SIP Service Provider. It is not the end-user who should understand the mechanics about how things work, so the main responsibility of making sure that things work correct falls into the hands of the SIP service provider who must properly setup its SIP infrastructure and support its user base.
6 2 Tijmen de Mes
7 2 Tijmen de Mes
h2. Refund Policy
8 2 Tijmen de Mes
9 2 Tijmen de Mes
Mac App Store does not provide refunds. If you purchased an application that do not like you are stuck with it. If you are not happy with this policy is Apple you must complain to, not us.
10 2 Tijmen de Mes
11 2 Tijmen de Mes
h2. Service Provider Problems
12 2 Tijmen de Mes
13 3 Tijmen de Mes
If you encounter connectivity problems like inability to receive incoming calls or failure to make outbound calls, you can find the reason by going to _Menu Window -> Logs -> SIP_. You should contact your SIP Service Provider and provide it with the information obtained from Blink logs.
14 2 Tijmen de Mes
15 2 Tijmen de Mes
h2. Software Problems
16 2 Tijmen de Mes
17 2 Tijmen de Mes
To report a problem, send an email to support@ag-projects.com. Please paste the relevant logs as explained below.
18 2 Tijmen de Mes
19 2 Tijmen de Mes
You can also check the history of the public Blink Support Forum.
20 2 Tijmen de Mes
21 4 Tijmen de Mes
h3. Critical Errors
22 2 Tijmen de Mes
23 5 Tijmen de Mes
If you experience a software crash, please send the complete crash report available in the crash reporter window (just copy and paste from it). Crash reports are saved in _~/Library/Logs/DiagnosticReports/_.
24 2 Tijmen de Mes
25 4 Tijmen de Mes
h3. Non-Critical Errors
26 2 Tijmen de Mes
27 5 Tijmen de Mes
Non-critical programming errors are logged in the system log file _/var/log/system.log._ You can isolate the entries by opening _Applications -> Utilities -> Console_, selecting _LOG FILES -> system.log_ and typing Blink in the search bar. Please provide us with this information when you report the problem you encountered.
28 2 Tijmen de Mes
29 4 Tijmen de Mes
h3. Configuration File
30 2 Tijmen de Mes
31 5 Tijmen de Mes
Blink accounts and settings are stored in a flat-text configuration file. The location of the configuration file is _~/Library/Application Support/Blink Pro/config_. Do not edit this file manually. If you did and Blink does not start you must delete the file and start all over again.
32 2 Tijmen de Mes
33 5 Tijmen de Mes
Please report your OS name and version and Blink version. You can find Blink version in menu _Blink -> About_.
34 6 Tijmen de Mes
35 11 Tijmen de Mes
h2. SIP Accounts
36 11 Tijmen de Mes
37 11 Tijmen de Mes
!http://icanblink.com/images/BlinkScreenshot-Enrollment.jpg! 
38 6 Tijmen de Mes
39 6 Tijmen de Mes
To use Blink, you need a SIP Account. At first start, Blink shows the Add Account window that helps you configure the initial SIP Account.
40 6 Tijmen de Mes
41 6 Tijmen de Mes
If you do not have a SIP Account, Blink can create one for you using the free service provided by SIP2SIP. For more information about the features of the SIP service go to http://sip2sip.info
42 6 Tijmen de Mes
43 6 Tijmen de Mes
If you already have a SIP Account from a SIP service provider, select this option then enter the SIP address in the form of user@domain and the password. If the SIP service provider has set his infrastructure correctly, all server address settings will be automatically discovered by Blink. If the SIP service provider was not capable of doing this, you may need to set some of the settings like server address, port and transport protocol manually, see the advanced settings section below.
44 6 Tijmen de Mes
45 6 Tijmen de Mes
You may configure Blink to use multiple SIP Accounts. To add a new SIP Account, go to menu Preferences->Accounts and click the + button. The Add Account window shows up and you can repeat the steps described above.
46 6 Tijmen de Mes
47 6 Tijmen de Mes
After you have configured an account, you can see the status of the registration in the account list of Main Window window. Solid color means that the account has successfully registered, gray color means that the registration has failed or is in progress. You can also see the status of the registration in the account list of Preferences window. Green color means that the account has successfully registered, Red color the registration has failed and Yellow means that he registration process is in progress.
48 6 Tijmen de Mes
49 6 Tijmen de Mes
A successful registration means that you are able to receive incoming calls with Blink.
50 6 Tijmen de Mes
51 6 Tijmen de Mes
h3. Advanced Account Settings
52 8 Tijmen de Mes
53 6 Tijmen de Mes
h4. Outbound Proxy
54 6 Tijmen de Mes
55 6 Tijmen de Mes
If the SIP provider does not have proper DNS records set for his domain to point to its SIP server address and port numbers as defined by RFC3263, Blink will not be able to auto-discover its location. In such case you must set the Outbound Proxy setting in Preferences -> SIP Account -> Advanced -> SIP Signaling. Also you can use this setting to force a specific transport or port different than the ones discovered from DNS. The outbound proxy format is host.example.com:5060;transport=udp.
56 6 Tijmen de Mes
57 6 Tijmen de Mes
h2. Main Interface
58 6 Tijmen de Mes
59 12 Tijmen de Mes
!http://icanblink.com/images/BlinkScreenshot-Contacts.jpg! 
60 12 Tijmen de Mes
61 6 Tijmen de Mes
Blink presents a Contacts driven interface as the main window. The design allows to locate a Contact then to start an action for it, for example to start an Audio Call. You can toggle to and from a dial-pad interface in the Contacts menu.
62 6 Tijmen de Mes
63 6 Tijmen de Mes
The main interface can be collapsed into a compact mode that hides the Contact List or dialpad. Click on the + Green button of the window to collapse and expand the main interface.
64 6 Tijmen de Mes
65 6 Tijmen de Mes
Hover the mouse over the GUI elements to see a short description of their function.
66 6 Tijmen de Mes
67 6 Tijmen de Mes
h3. SIP Account
68 6 Tijmen de Mes
69 6 Tijmen de Mes
You can select the SIP Account used for outbound sessions in the Accounts drop down box presented on the top of the main interface.
70 6 Tijmen de Mes
71 6 Tijmen de Mes
h4. Bonjour Account
72 6 Tijmen de Mes
73 6 Tijmen de Mes
Bonjour Account is a special type of account that is designed to announce itself and discover other neighbours on the local area network. This account does not require a server or SIP service in order to operate.
74 6 Tijmen de Mes
75 6 Tijmen de Mes
h3. Search Bar
76 6 Tijmen de Mes
77 6 Tijmen de Mes
The Search bar is used for finding an existing contact or for entering a SIP address or telephone number.
78 6 Tijmen de Mes
79 6 Tijmen de Mes
To search for a contact in Blink's Contacts List, system Address Book and optionally configured LDAP directory of the active account, fill in the name in the Search Bar. You may select a Contact that matched the typed text or use the typed text as the Contact for the next action.
80 6 Tijmen de Mes
81 6 Tijmen de Mes
Use the buttons presented at the bottom of the main window to start a session to the current selected Contact or press on Add Contact to add the typed address to the Contacts List.
82 6 Tijmen de Mes
83 6 Tijmen de Mes
Pressing enter or return after entering text in the search bar will start an audio call to that address.
84 6 Tijmen de Mes
85 6 Tijmen de Mes
h3. Contacts List
86 6 Tijmen de Mes
87 6 Tijmen de Mes
Contacts can be organized in Groups. The Groups support ordering and can be collapsed or expanded when clicking on their left-side triangle. Groups can be dragged in different order. Contacts can be dragged from one group to another.
88 6 Tijmen de Mes
89 1 Tijmen de Mes
Right click on a Contact to see all possible actions for each of them.
90 6 Tijmen de Mes
91 7 Tijmen de Mes
h4. Address Book
92 6 Tijmen de Mes
93 6 Tijmen de Mes
The group named Address Book cannot be deleted, it is dynamically populated with entries from the system Address Book. To reload changes made in the Address Book collapse and expand the group again.
94 6 Tijmen de Mes
95 6 Tijmen de Mes
For Address Book entries, to have a SIP Address recognized by Blink you must have entries in either Email or URL sections that start with the sip: prefix.
96 6 Tijmen de Mes
97 6 Tijmen de Mes
One can initiate an audio call using Blink Pro directly from the AddressBook application by clicking on the Phone, Email or URL fields of an AddressBook contact. For this you must install the AddressBook plugins available at:
98 6 Tijmen de Mes
99 6 Tijmen de Mes
http://download.ag-projects .com/BlinkABPlugins/
100 1 Tijmen de Mes
101 6 Tijmen de Mes
The plugins work with Blink Pro version 1.8.2 or newer.
102 6 Tijmen de Mes
103 7 Tijmen de Mes
h4. Bonjour Neighbours
104 6 Tijmen de Mes
105 6 Tijmen de Mes
Bonjour Neighbours appear in the Contacts List as a separate Group. When selecting Bonjour as the default account, Bonjour Neighbours group is expanded and moved on top of the Contacts list. When changing back to a regular SIP Account, the groups in the Contacts list reshuffle to their previous positions.
106 6 Tijmen de Mes
107 1 Tijmen de Mes
Chat sessions are automatically accepted from Bonjour Neighbours.
108 6 Tijmen de Mes
109 6 Tijmen de Mes
Audio sessions can be automatically accepted based on the correspondent setting from Account menu.
110 1 Tijmen de Mes
111 7 Tijmen de Mes
h4. Edit Contact
112 6 Tijmen de Mes
113 1 Tijmen de Mes
You can edit a Contact by right clicking on it and select Edit menu option. Edit Contact window appears. To set the Icon for the Contact, click on the Icon area, a file selection dialog appears.
114 6 Tijmen de Mes
115 7 Tijmen de Mes
h4. Add Contact
116 1 Tijmen de Mes
117 6 Tijmen de Mes
You can add a Contact to the Contacts List by clicking on the + button presented on the bottom left of the main interface. Add Contact window appears.
118 6 Tijmen de Mes
119 7 Tijmen de Mes
h4. Server Storage
120 6 Tijmen de Mes
121 6 Tijmen de Mes
If a contact is associated with an account and the SIP service that provides the account has XCAP storage capabilities, the contact is then also stored on the XCAP server. Multiple Blink instances can be synchronized in real time by using this feature.
122 6 Tijmen de Mes
123 7 Tijmen de Mes
h4. Special Groups
124 1 Tijmen de Mes
125 6 Tijmen de Mes
In Preferences Contact section, special groups like Favorites or Missed Calls can be enabled.
126 6 Tijmen de Mes
127 7 Tijmen de Mes
h3. Start Session
128 6 Tijmen de Mes
129 6 Tijmen de Mes
Use the buttons presented at the bottom of the main window to start a session to the current selected Contact.
130 1 Tijmen de Mes
131 6 Tijmen de Mes
Clicking on Return key or double-clicking a Contact will start the default session type depending on the preferred media configured for each Contact. The default action is to start an Audio Call.
132 6 Tijmen de Mes
133 7 Tijmen de Mes
h2. Alert Panel
134 6 Tijmen de Mes
135 13 Tijmen de Mes
!http://icanblink.com/images/BlinkScreenshot-AlertPanel-DS.jpg!
136 13 Tijmen de Mes
137 6 Tijmen de Mes
Incoming session requests bring up the Alert Panel. Click on the Accept Button to accept a session request. There are two options for rejecting an incoming session request:
138 6 Tijmen de Mes
139 7 Tijmen de Mes
 * Click on the Reject button. The session is rejected with SIP response code 603 and all other SIP devices registered for the same account stop ringing. Forwarding to voicemail or other destinations, when available in the SIP server is also cancelled. You must use this option to terminate all call processing associated with the request.
140 7 Tijmen de Mes
 * Click on the Busy button. Blink sends a 486 code back to the caller and stops ringing, other SIP devices keep ringing and forwarding to other destinations remains active as set in the SIP server. You must use this option when you want to pick up the call at a different location or allow the Server to perform other pre-configured routing decisions.
141 6 Tijmen de Mes
When the Answering Machine is enabled, a countdown appears in the Alert Panel. While the countdown counts you can still disable the Answering Machine from the Account menu.
142 6 Tijmen de Mes
143 6 Tijmen de Mes
The currently selected input and output audio devices are showed for incoming Audio Call requests.
144 6 Tijmen de Mes
145 7 Tijmen de Mes
h2. Audio Calls
146 1 Tijmen de Mes
147 14 Tijmen de Mes
!http://icanblink.com/images/BlinkScreenshot-AudioSessions.jpg!
148 6 Tijmen de Mes
149 6 Tijmen de Mes
Audio Calls are displayed in the lateral drawer attached to the main interface.
150 6 Tijmen de Mes
151 6 Tijmen de Mes
To start an Audio Call, select an existing contact or enter a SIP address or telephone number in the search bar. Once text is entered in the search bar just press enter to start an audio call to that address. Alternatively, you can turn on the dialpad in the Contacts menu and press its keys.
152 1 Tijmen de Mes
153 1 Tijmen de Mes
When a Contact is selected, you may click on the Green Handset located at the bottom of the main interface or right click on thr Contact and select Start Audio Session from the contextual menu. For each new call an entry is added to the Audio Calls drawer.
154 1 Tijmen de Mes
155 6 Tijmen de Mes
To switch between multiple calls just click on another call in the audio sessions drawer. When switching to a particular session, the audio stream is connected to the input and output device and all other Audio Calls are put on hold.
156 6 Tijmen de Mes
157 6 Tijmen de Mes
To add Chat to an existing Audio Call, right click on the session displayed in the Audio Drawer and select an Add Chat
158 6 Tijmen de Mes
159 6 Tijmen de Mes
To mute your microphone click on the bottom right microphone icon. To un-mute click it again.
160 6 Tijmen de Mes
161 7 Tijmen de Mes
h3. Codecs
162 6 Tijmen de Mes
163 6 Tijmen de Mes
Audio codecs can be set in Preferences -> Advanced -> RTP Media section and can be overwritten per account in Advanced -> RTP Media section. By default, the audio codecs are prioritized to allow for highest quality and second, compatibility with SIP services.
164 6 Tijmen de Mes
165 6 Tijmen de Mes
If you have changed the defaults or want to set the codecs manually, for high quality conversations is recommended to use G.722 codec as first choice and leave PCMA and PCMU enabled for compatibility reasons. Some details about the codecs used by Blink:
166 6 Tijmen de Mes
167 7 Tijmen de Mes
 * G.722 is the most compatible wideband codec supported by both software and hardware phones
168 7 Tijmen de Mes
 * Speex is another high quality codec that works with many soft phones
169 7 Tijmen de Mes
 * PCMA and PCMU are the most interoperable codecs that work with almost any device
170 7 Tijmen de Mes
 * GSM and iLBC use less bandwidth than the other codecs but they have less support in service provider equipment
171 1 Tijmen de Mes
172 8 Tijmen de Mes
h3. DTMF
173 6 Tijmen de Mes
174 6 Tijmen de Mes
Dial tones are used to interact with PBX and IVR systems or legacy PSTN gateways. To send DTMF tones, focus the Audio Call by clicking on it. The current call is already focused if you just started it. What you then type on the keyboard is automatically translated into DTMF tones. Alpha-numeric keys are translated into numeric DTMF keys as they are on a numeric telephone keypad. Also you may use the dialpad for this purpose.
175 6 Tijmen de Mes
176 1 Tijmen de Mes
If a telephone number with a # sign is dialed, what comes after the # sign will be automatically entered as DTMF codes once the call is connected. Supported DTMF codes are 0-9*#. You can use the comma sign ',' to insert a one second pause (version >=1.5.1).
177 6 Tijmen de Mes
178 8 Tijmen de Mes
h3. Hangup
179 1 Tijmen de Mes
180 6 Tijmen de Mes
To hangup click on the Red handset displayed for each Audio Session in the right hand side of the drawer or press the Escape key.
181 6 Tijmen de Mes
182 8 Tijmen de Mes
h3. Hold/Unhold
183 6 Tijmen de Mes
184 6 Tijmen de Mes
The shortcut key for hold and unhold of the selected session is Space.
185 1 Tijmen de Mes
186 8 Tijmen de Mes
h3. Record
187 6 Tijmen de Mes
188 6 Tijmen de Mes
To record click on the Black circle. While recording, the circle will toggle between red and black. Recorded sessions can be found in menu Audio -> Recordings.
189 6 Tijmen de Mes
190 8 Tijmen de Mes
h3. Transfer
191 6 Tijmen de Mes
192 6 Tijmen de Mes
To blindly transfer a call, just drag it to a contact in the Contacts list. You can also enter a number or address in the search bar, to transfer a call to an arbitrary address.
193 1 Tijmen de Mes
194 6 Tijmen de Mes
To perform an assisted call transfer, first establish a call to each party. Then, click on the T button for completing the transfer, a contextual menu is presented.
195 6 Tijmen de Mes
196 8 Tijmen de Mes
h3. Call History
197 6 Tijmen de Mes
198 6 Tijmen de Mes
History of previous sessions is available in the History menu. If you have registered a SIP Account with Blink, you can review the missed calls while Blink was off-line in Account-> Settings on SIP Server -> History menu.
199 1 Tijmen de Mes
200 8 Tijmen de Mes
h3. Redial
201 6 Tijmen de Mes
202 6 Tijmen de Mes
To redial the last session type Command-R, to redial a previous session select it in the History menu.
203 6 Tijmen de Mes
204 8 Tijmen de Mes
h3. iTunes Integration
205 1 Tijmen de Mes
206 6 Tijmen de Mes
iTunes automatically pauses playing before any Audio Call pauses and resumes playing after all Audio Calls have finished.
207 6 Tijmen de Mes
208 8 Tijmen de Mes
h3. Audio Information
209 6 Tijmen de Mes
210 14 Tijmen de Mes
!http://icanblink.com/images/BlinkScreenshot-ICE.jpg!
211 6 Tijmen de Mes
212 6 Tijmen de Mes
Audio Calls have status indication about the progress of establishment of the RTP stream and ICE negotiation, the negotiated codec and the presence of encryption for signaling and media.
213 6 Tijmen de Mes
214 6 Tijmen de Mes
The RTP end-points and negotiated ICE candidates (when ICE negotiation succeeded) are displayed when hovering the mouse over the Audio codec information area.
215 6 Tijmen de Mes
216 8 Tijmen de Mes
h3. Calling Telephone Numbers
217 6 Tijmen de Mes
218 6 Tijmen de Mes
To dial a telephone number, just enter the number in the Search Box followed by Enter or Return key.
219 1 Tijmen de Mes
220 6 Tijmen de Mes
When dialing numbers by selecting entries from the Address Book it is recommended that you store your numbers in international E.164 format (that is + sign followed by the country code then the subscriber number).
221 6 Tijmen de Mes
222 1 Tijmen de Mes
You can set in the account Advanced -> Phone Numbers preferences section how to replace the + sign with another prefix recognized by your SIP service provider or PBX. For example if you set Replace Starting + with 001, when you dial +44XXX the number will be dialed as 00144XXX.
223 6 Tijmen de Mes
224 6 Tijmen de Mes
Optionally, phone numbers can be also prefixed before dialing out, for example if a 9 is required by your PBX by setting the External Line Prefix option.
225 6 Tijmen de Mes
226 6 Tijmen de Mes
If you have created a SIP Account with Blink, you can call to PSTN numbers if you must have a positive credit. You can use a Credit Card to add Credit to your SIP Account in menu Tools -> Call To Phone Numbers.... You may request the assignment of a PSTN Caller Id by opeing a ticket in the server support interface. Recognized number formats are + or 00 followed by the Country Code and then Subscriber Number.
227 6 Tijmen de Mes
228 6 Tijmen de Mes
If you use another SIP Account than the one provided by Blink, access to the PSTN is subject to the support provided by your SIP service provider. The number format depends as well on the conventions imposed by the SIP service provider in question.
229 1 Tijmen de Mes
230 8 Tijmen de Mes
h3. Voicemail
231 6 Tijmen de Mes
232 6 Tijmen de Mes
Voicemail is a feature provided for SIP accounts created by Blink. It is provided by the network while Blink is offline, when the call forwarding to Voicemail is activated. To change the settings of your SIP2SIP voicemail box dial 1233. You can record your unavailable message and listen to your messages stored on the server. The voicemail delivered method (by email attachement or by dialing into the server) is set in menu Tools -> Settings on SIP server in the Voicemail section.
233 6 Tijmen de Mes
234 8 Tijmen de Mes
h3. Answering Machine
235 6 Tijmen de Mes
236 6 Tijmen de Mes
When the Answering Machine is enabled, Audio Call requests will be automatically answered with either the standard or the custom recorded message after the delay configured set in Preferences -> Answering Machine settings.
237 6 Tijmen de Mes
238 6 Tijmen de Mes
You can enable the Answering Machine using the menu item Tools -> Enable Answering Machine. The incoming Audio Calls are then recorded and can be listened to later in Tools -> Recordings menu.
239 6 Tijmen de Mes
240 6 Tijmen de Mes
While the Answering Machine is handling an Audio Call, you can hear what the remote party is speaking while your microphone is muted. If you wish you can take over by clicking on the Green Handset icon in the Audio drawer. The recording stops and the session is connected to the microphone.
241 1 Tijmen de Mes
242 8 Tijmen de Mes
h3. Audio Conference
243 6 Tijmen de Mes
244 15 Tijmen de Mes
!http://icanblink.com/images/BlinkScreenshot-AudioConference.jpg!
245 6 Tijmen de Mes
246 6 Tijmen de Mes
Drag and drop Audio Calls on top of each other to create a Conference or use the button presented at the botton at the Audio Drawer to start a Conference with all active Audio Calls.
247 6 Tijmen de Mes
248 6 Tijmen de Mes
Add new participants to a Conference by dragging Contacts from the Contacts list onto an Audio Call.
249 6 Tijmen de Mes
250 6 Tijmen de Mes
Each participant can be muted individually by pressing on the microphone symbol that appears on each conferenced session.
251 6 Tijmen de Mes
252 6 Tijmen de Mes
To end an Audio Conference drag the session out of the conference area or press the Conference button again.
253 6 Tijmen de Mes
254 6 Tijmen de Mes
There can be only one active Audio Conference at any given time.
255 6 Tijmen de Mes
256 8 Tijmen de Mes
h2. Chat Sessions
257 6 Tijmen de Mes
258 22 Tijmen de Mes
!http://icanblink.com/images/BlinkScreenshot-ServerConference.jpg!
259 6 Tijmen de Mes
260 6 Tijmen de Mes
Chat Sessions are displayed into the Chat window. For each recipient there is a new Tab created at the bottom of the window. The Tabs are matched based on the SIP Address of the recipient and the Chat Aliases configured for the Contacts.
261 6 Tijmen de Mes
262 6 Tijmen de Mes
The lateral drawer display the active participants present in the chat session or multi-party conference.
263 6 Tijmen de Mes
264 6 Tijmen de Mes
Chat Sessions are encrypted using TLS and handled like the Audio Sessions, a Chat Session is established only to the device where the user accepts the session. Chat sessions can carry arbitrarily large amounts of text information.
265 6 Tijmen de Mes
266 6 Tijmen de Mes
You can start a Chat Session by right-clicking on a Contact and chose Start Chat Session.
267 6 Tijmen de Mes
268 6 Tijmen de Mes
Messages typed before the session is accepted by the remote party are queued and delivered once the session has been established. If the session fails to establish, the undelivered messages will be resent at the next successful attempt.
269 6 Tijmen de Mes
270 6 Tijmen de Mes
Message marked with a red color background have failed to be delivered.
271 6 Tijmen de Mes
272 6 Tijmen de Mes
To an established Chat Session you can add Audio or start a Screen Sharing session by clicking on the buttons presented on the toolbar.
273 6 Tijmen de Mes
274 6 Tijmen de Mes
To review previous chat conversations go to menu History -> Chat Conversations.
275 6 Tijmen de Mes
276 6 Tijmen de Mes
To insert an empty line use Shift-Enter combination.
277 6 Tijmen de Mes
278 6 Tijmen de Mes
The rendering of Emoticons can be disabled in each chat window, this can be useful to transfer programming code snippets without interpreting the special characters as emoticons.
279 6 Tijmen de Mes
280 9 Tijmen de Mes
h2. Short Messages
281 6 Tijmen de Mes
282 6 Tijmen de Mes
Short Messages is the way to interact with legacy SIP IM clients that do not support session based Chat Sessions using MSRP protocol.
283 6 Tijmen de Mes
284 6 Tijmen de Mes
Short Messages end-up on all SIP devices registered for the remote SIP Account, including hardware phones that accept such messages but do not display them, the recipient has no control where to receive them. Short Messages have no end-to-end delivery report and cannot be encrypted the way Chat Sessions are.
285 6 Tijmen de Mes
286 6 Tijmen de Mes
A Short Message cannot exceed 1300 characters on IP networks and 160 on PSTN mobile networks.
287 6 Tijmen de Mes
288 6 Tijmen de Mes
You can send a Short Message by right-clicking on a Contact and chose Send SMS.
289 6 Tijmen de Mes
290 6 Tijmen de Mes
Previous exchanged messages can be reviewed in the menu Window -> Chat History.
291 6 Tijmen de Mes
292 9 Tijmen de Mes
h2. File Transfers
293 6 Tijmen de Mes
294 21 Tijmen de Mes
!http://icanblink.com/images/BlinkScreenshot-FileTransfer.jpg!
295 6 Tijmen de Mes
296 6 Tijmen de Mes
To send a file you can use drag and drop from Finder or other application like iPhoto onto a Contact, to a Chat Window or by right clicking on a Contact and then selecting Send File... option.
297 6 Tijmen de Mes
298 6 Tijmen de Mes
File Transfers are displayed in a separate window. Each file has a progress bar attached with estimated transfer speed and remaining time.
299 6 Tijmen de Mes
300 9 Tijmen de Mes
h2. Screen Sharing
301 6 Tijmen de Mes
302 6 Tijmen de Mes
Screen Sharing is implemented by using standard VNC protocol over an MSRP connection. The minimum bandwidth required for a reasonable experience us 1 Mbit/s. Make sure that all debugging is disabled during Screen Sharing as it can overload the CPU.
303 6 Tijmen de Mes
304 6 Tijmen de Mes
The party sharing the Screen must have enabled Screen Sharing in System Preferences and set the option Anyone may request permission to control screen in Computer Settings section of the Share Screen panel.
305 6 Tijmen de Mes
306 20 Tijmen de Mes
!http://icanblink.com/images/BlinkScreenshot-ScreenSharingServerSetup.jpg!
307 20 Tijmen de Mes
308 9 Tijmen de Mes
h3. Screen Sharing Party
309 1 Tijmen de Mes
310 1 Tijmen de Mes
First Blink alerts the user about an incoming request for Screen Sharing. If accepted, MacOSX VNC server will asks to confirm the Screen Sharing request. The request originates from the localhost (127.0.0.1) as the connection runs through Blink.
311 19 Tijmen de Mes
312 19 Tijmen de Mes
!http://icanblink.com/images/BlinkScreenshot-ScreenSharingServerConfirmation.jpg!
313 6 Tijmen de Mes
314 9 Tijmen de Mes
h3. Screen Viewer Party
315 6 Tijmen de Mes
316 1 Tijmen de Mes
The party asking for Screen Sharing must select the option 'Connect by Asking for Permission' when prompted by the VNC viewer.
317 6 Tijmen de Mes
318 18 Tijmen de Mes
!http://icanblink.com/images/BlinkScreenshot-ScreenSharingClientRequest.jpg!
319 6 Tijmen de Mes
320 9 Tijmen de Mes
h2. NAT Traversal
321 6 Tijmen de Mes
322 6 Tijmen de Mes
For NAT traversal you must rely on your SIP service provider. In general, every SIP service provides relaying for both signaling and media, which takes care of the NAT issue. This means that no special settings are necessary in the client.
323 6 Tijmen de Mes
324 9 Tijmen de Mes
h3. Audio
325 6 Tijmen de Mes
326 6 Tijmen de Mes
For Audio Calls you can enable the use of ICE negotiation in Advanced -> NAT Traversal -> Use ICE. ICE requires the presence of STUN servers, they must be provided by the SIP service provider. The ICE negotiation details are displayed in RTP Logs window. While the ICE negotiation progresses, its status is also displayed in the Audio Call information, for example the gathering of ICE the candidates and the probing of the remote candidates.
327 6 Tijmen de Mes
328 6 Tijmen de Mes
Once the audio stream is established, the audio information area is updated with the negotiated codec type and the sample rate. The active RTP end-points and the ICE candidates types are displayed while hovering the mouse over the audio status information area.
329 6 Tijmen de Mes
330 9 Tijmen de Mes
h3. IM and File Transfers
331 6 Tijmen de Mes
332 6 Tijmen de Mes
To traverse the NAT for MSRP related sessions (Instant Messaging, File Transfer) a MSRP relay configured for the called party domain is needed. The SIP service provider that provides the SIP Account must support this feature (e.g. http://sip2sip.info).
333 6 Tijmen de Mes
334 9 Tijmen de Mes
h3. Screen Sharing
335 6 Tijmen de Mes
336 6 Tijmen de Mes
To traverse the NAT for Screen Sharing sessions a MSRP relay configured for the called party domain is needed. The SIP service provider that provides the SIP Account must support this feature (e.g. http://sip2sip.info).
337 6 Tijmen de Mes
338 9 Tijmen de Mes
h2. Growl Notifications
339 6 Tijmen de Mes
340 6 Tijmen de Mes
Growl notifications are raised for missed sessions and the Dock Icon badge is updated with the number of missed sessions.
341 6 Tijmen de Mes
342 6 Tijmen de Mes
When sessions are accepted elsewhere and the SIP server supports the Reason header, the sessions will be logged in the incoming section rather than the missed section.
343 6 Tijmen de Mes
344 9 Tijmen de Mes
h2. Logs
345 6 Tijmen de Mes
346 6 Tijmen de Mes
Logs Window helps troubleshoot network traffic for various protocols used by Blink. For example, one can follow in the self scrolling interface the time sequence of all DNS lookups and SIP messages exchanged with the other end-points.
347 6 Tijmen de Mes
348 6 Tijmen de Mes
To see what Blink is doing under the hood go to the menu Window -> Logs. It is advisable not to leave MSRP Trace and Notifications Logs turned on unless you really need them for debugging purposes, they are very demanding in terms of CPU load during File Transfer and Screen Sharing sessions.
349 6 Tijmen de Mes
350 9 Tijmen de Mes
h2. Server Settings
351 6 Tijmen de Mes
352 17 Tijmen de Mes
!http://icanblink.com/images/BlinkScreenshot-DND.jpg!
353 6 Tijmen de Mes
354 6 Tijmen de Mes
Blink is integrated with the SIP2SIP server functionality. One can change settings directly on the SIP server like Call Forwarding, Do Not Disturb, list of last missed sessions and other settings.
355 6 Tijmen de Mes
356 6 Tijmen de Mes
The settings are displayed in Server Settings window. The window is actually a web interface that loads the URL configured in the Advanced -> Server -> Settings URL for each SIP Account. The remote web server can support digest authentication, Blink sends the SIP Account credentials when prompted by the server.
357 6 Tijmen de Mes
358 9 Tijmen de Mes
h2. Audio Devices
359 6 Tijmen de Mes
360 6 Tijmen de Mes
Blink auto-detects audio devices there are plugged in and out on the fly and prompts the user to switch to a new added device. You can switch automatically by setting this option in Preferences -> Audio section.
361 6 Tijmen de Mes
362 6 Tijmen de Mes
To selected a particular audio device use the menu Audio.
363 6 Tijmen de Mes
364 9 Tijmen de Mes
h2. Preferences
365 6 Tijmen de Mes
366 16 Tijmen de Mes
!http://icanblink.com/images/BlinkScreenshot-Preferences.jpg!
367 6 Tijmen de Mes
368 6 Tijmen de Mes
To change Blink configuration go to menu Preferences. The Preferences window appears.
369 6 Tijmen de Mes
370 1 Tijmen de Mes
Find out more information about a particular setting by hovering the mouse over it.
371 1 Tijmen de Mes
372 6 Tijmen de Mes
Each SIP Account has advanced options available, to reveal them click on the small triangle presented under the SIP Address.
373 6 Tijmen de Mes
374 6 Tijmen de Mes
Blink preferences are stored in ~/Library/Application Support/Blink Pro folder. You can reset Blink by deleting this folder.
375 1 Tijmen de Mes
376 6 Tijmen de Mes
Blink SIP accounts and settings are stored in ~/Library/Application Support/Blink Pro/config file.
377 1 Tijmen de Mes
378 6 Tijmen de Mes
GUI preferences are stored in ~/Library/Preferences/com.agprojects.Blink.plist file. (e.g. size, location of the windows and other MacOSX related settings).
379 6 Tijmen de Mes
380 6 Tijmen de Mes
If you ever want to move your Blink configuration to another login account you must edit the content of your config file and replace the absolute file paths accordingly. You can edit this file with any text editor as long as you do not break the return lines and formatting of the file.
381 1 Tijmen de Mes
382 9 Tijmen de Mes
h3. Codecs
383 1 Tijmen de Mes
384 1 Tijmen de Mes
Blink supports G722 and Speex wide-band codecs. The order of the codecs can be configured in menu Preferences -> Advanced -> RTP Media and for each SIP Account in Preferences -> Accounts -> Advanced -> RTP Media.
385 6 Tijmen de Mes
386 9 Tijmen de Mes
h3. Open Browser on Incoming Call
387 9 Tijmen de Mes
388 6 Tijmen de Mes
You can configure Blink Pro to automatically open a web browser on an incoming call event. For this set the Alert URL in Preferences -> Advanced -> Server Settings section.
389 1 Tijmen de Mes
390 6 Tijmen de Mes
The URL may contain the following variables that will be replaced with the actual information from the incoming session:
391 6 Tijmen de Mes
392 9 Tijmen de Mes
 * $caller_party - the SIP address of the caller party
393 9 Tijmen de Mes
 * $called_party - the SIP address of the account being called
394 10 Tijmen de Mes
395 6 Tijmen de Mes
Example: http://www.example.com?caller=$caller_party&called=$called_party
396 1 Tijmen de Mes
397 9 Tijmen de Mes
h2. History Database
398 1 Tijmen de Mes
399 1 Tijmen de Mes
Blink stores the history of sessions and chat messages in a Sqlite database. The location of the database is:
400 1 Tijmen de Mes
401 9 Tijmen de Mes
<pre>
402 6 Tijmen de Mes
~/Library/Application Support/Blink Pro/history/history.sqlite
403 9 Tijmen de Mes
</pre>
404 9 Tijmen de Mes
405 6 Tijmen de Mes
If for any reason the database becomes corrupted, which may manifest itself by errors reported graphically by Blink itself or in the Console application you may work around the problems in several ways.
406 6 Tijmen de Mes
407 6 Tijmen de Mes
First, backup your database in case you need the uncorrupted data in the future. You can do this by copying the history.sqlite file to another location. The file can be opened in Terminal application using sqlite3 program. You can dump the old data in the corrupted database as follows:
408 6 Tijmen de Mes
409 9 Tijmen de Mes
<pre>
410 6 Tijmen de Mes
#:~/Library/Application Support/Blink Pro/history$sqlite3 history.sqlite 
411 6 Tijmen de Mes
SQLite version 3.7.7 2011-06-25 16:35:41
412 6 Tijmen de Mes
Enter ".help" for instructions
413 6 Tijmen de Mes
Enter SQL statements terminated with a ";"
414 6 Tijmen de Mes
sqlite> select * from sessions;
415 6 Tijmen de Mes
sqlite> select * from chat_messages;
416 9 Tijmen de Mes
</pre>
417 6 Tijmen de Mes
418 9 Tijmen de Mes
h3. Restore Procedure
419 9 Tijmen de Mes
420 6 Tijmen de Mes
Try the following in this order to solve a data corruption problem:
421 6 Tijmen de Mes
422 9 Tijmen de Mes
 * Clear the session history table, go to menu History-> Clear History. The session table will be emptied and the chat messages are not affected. Restart Blink.
423 9 Tijmen de Mes
 * Stop Blink. Remove history.sqlite file, the history database will be recreated at start time. Use the backup file for reading the old data using the sqlite3 command line utility.