Help For Blink Pro
Version 156 (Adrian Georgescu, 10/27/2014 10:36 am)
1 | 147 | Adrian Georgescu | h1. Help for Blink Pro and Blink Lite for OSX |
---|---|---|---|
2 | 1 | Tijmen de Mes | |
3 | 147 | Adrian Georgescu | For help on Blink QT go "here":http://projects.ag-projects.com/projects/blinkqt/wiki/Help |
4 | 65 | Adrian Georgescu | |
5 | 66 | Adrian Georgescu | [[KnownIssues|Known issues and critical bug fixes]] |
6 | 1 | Tijmen de Mes | |
7 | 147 | Adrian Georgescu | [[MostEncounteredProblems| Most Encountered Problems]] |
8 | 1 | Tijmen de Mes | |
9 | 154 | Adrian Georgescu | To use Blink you need a SIP account from a SIP service provider. Similar to using an email program, you must configure Blink with the account you have obtained from your service provider. If things do not work the way you expect, there can be several reasons. The cause may be located by Blink software itself, the network connectivity or the SIP Service Provider. While Blink may not be bug free, based on experience so far most of the problems are related to the network connectivity (packet loss, presence of a broken SIP ALG router) or/and the SIP Service Provider (most provider only support Voice calls). 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. To eliminate some possible causes, try to use the built-in accounts provided by Blink, all features are known to be working using these accounts. |
10 | 154 | Adrian Georgescu | |
11 | 1 | Tijmen de Mes | |
12 | 150 | Adrian Georgescu | h2. Refunds |
13 | 1 | Tijmen de Mes | |
14 | 150 | Adrian Georgescu | If you purchased an application on Mac App Store you must ask Apple for the refund. Some web page describing the process is here http://gizmodo.com/5886683/how-to-get-a-refund-from-the-app-store |
15 | 150 | Adrian Georgescu | |
16 | 149 | Adrian Georgescu | |
17 | 147 | Adrian Georgescu | h2. Requesting Support |
18 | 1 | Tijmen de Mes | |
19 | 147 | Adrian Georgescu | h3. Public Forum Discussions |
20 | 1 | Tijmen de Mes | |
21 | 147 | Adrian Georgescu | Go to "Blink Support Forum":http://support.icanblink.com |
22 | 1 | Tijmen de Mes | |
23 | 147 | Adrian Georgescu | h3. Support from Developers |
24 | 1 | Tijmen de Mes | |
25 | 147 | Adrian Georgescu | If you need support for a particular problem you can mail us directly to support@ag-projects.com. Please try this as a last resort as the answer may already be available on the discussion forum or other users may have encountered your problem while the developers may not. |
26 | 1 | Tijmen de Mes | |
27 | 147 | Adrian Georgescu | h3. Placing Calls Problems |
28 | 1 | Tijmen de Mes | |
29 | 147 | Adrian Georgescu | To eliminate possible causes related to local network or service provider, please check if the problem can be reproduce by using the Free SIP Accounts provided with Blink. |
30 | 1 | Tijmen de Mes | |
31 | 156 | Adrian Georgescu | h3. Sending a crash report |
32 | 156 | Adrian Georgescu | |
33 | 147 | Adrian Georgescu | If you are unable to receive incoming or place outgoing calls do the following: |
34 | 1 | Tijmen de Mes | |
35 | 1 | Tijmen de Mes | * Make sure you run the last version available in the Mac App Store. |
36 | 156 | Adrian Georgescu | * Go to menu Window -> Logs. Enable SIP (select Everything), Notifications and Engine logs |
37 | 156 | Adrian Georgescu | * Go to Preferences -> Advanced -> File Logging |
38 | 156 | Adrian Georgescu | * Click on Purge Logs button |
39 | 156 | Adrian Georgescu | * Attempt to make the call that causes the problem |
40 | 156 | Adrian Georgescu | |
41 | 156 | Adrian Georgescu | Make an archive with: |
42 | 156 | Adrian Georgescu | |
43 | 156 | Adrian Georgescu | * ~/Library/Containers/com.agprojects.Blink/Data/Library/Application\ Support/Blink\ Pro/logs/ |
44 | 156 | Adrian Georgescu | * In case of complete software crash, the Blink crash report, you can find it using Console application |
45 | 156 | Adrian Georgescu | * Blink Activity logs from Console Application. To get these logs, filter by Blink and select File -> Save a copy as... |
46 | 156 | Adrian Georgescu | |
47 | 156 | Adrian Georgescu | Send the archive to support@ag-projects.com |
48 | 156 | Adrian Georgescu | |
49 | 156 | Adrian Georgescu | |
50 | 1 | Tijmen de Mes | |
51 | 147 | Adrian Georgescu | h3. Non-critical Errors |
52 | 1 | Tijmen de Mes | |
53 | 147 | Adrian Georgescu | Blink errors are logged in the OSX system log file _/var/log/system.log_. You can find them 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. |
54 | 141 | Adrian Georgescu | |
55 | 147 | Adrian Georgescu | h3. Software Crashes |
56 | 1 | Tijmen de Mes | |
57 | 147 | Adrian Georgescu | If you experience a software crash, please send the complete crash report available in the crash reporter window (just copy and paste from it). |
58 | 1 | Tijmen de Mes | |
59 | 147 | Adrian Georgescu | Crash reports are saved in _~/Library/Logs/DiagnosticReports/_. |
60 | 1 | Tijmen de Mes | |
61 | 147 | Adrian Georgescu | h3. Configuration File |
62 | 1 | Tijmen de Mes | |
63 | 147 | Adrian Georgescu | Blink accounts and settings are stored in a flat-text configuration file. |
64 | 1 | Tijmen de Mes | |
65 | 147 | Adrian Georgescu | * Pro version: ~/Library/Containers/com.agprojects.Blink/Data/Library/Application Support/Blink Pro/config |
66 | 147 | Adrian Georgescu | * Lite version: ~/Library/Containers/com.agprojects.BlinkLite/Data/Library/Application Support/Blink Lite/config |
67 | 147 | Adrian Georgescu | * SIP2SIP version: ~/Library/Application Support/SIP2SIP/config |
68 | 1 | Tijmen de Mes | |
69 | 147 | Adrian Georgescu | Do not edit this file manually. If you did and Blink does not start you must delete the file and start all over again. |
70 | 1 | Tijmen de Mes | |
71 | 147 | Adrian Georgescu | Please report your OS name and version and Blink version. You can find Blink version in menu _Blink -> About_. |
72 | 1 | Tijmen de Mes | |
73 | 147 | Adrian Georgescu | Passwords are not stored in the configuration file but in the system keychain. |
74 | 1 | Tijmen de Mes | |
75 | 147 | Adrian Georgescu | h2. Differences between Pro and Lite versions |
76 | 1 | Tijmen de Mes | |
77 | 147 | Adrian Georgescu | Compared to Blink Lite, Blink Pro has the following extra features: |
78 | 1 | Tijmen de Mes | |
79 | 155 | Adrian Georgescu | * OSX Integration (iCloud sync, iTunes pause, Address Book plugin, KeyChain support, Voice Over capability) |
80 | 155 | Adrian Georgescu | * Unlimited number of SIP accounts |
81 | 155 | Adrian Georgescu | * History browser for all media types |
82 | 147 | Adrian Georgescu | * Phone number translations |
83 | 155 | Adrian Georgescu | * Call transfer and call recording |
84 | 147 | Adrian Georgescu | * LDAP server support |
85 | 147 | Adrian Georgescu | * Incoming call web page integration |
86 | 147 | Adrian Georgescu | * AddressBook plugin |
87 | 1 | Tijmen de Mes | * More granular settings |
88 | 147 | Adrian Georgescu | |
89 | 1 | Tijmen de Mes | SIP2SIP version is equivalent with Pro version but it can only use one account from sip2sip.info service. |
90 | 147 | Adrian Georgescu | |
91 | 1 | Tijmen de Mes | |
92 | 147 | Adrian Georgescu | h2. SIP Accounts |
93 | 1 | Tijmen de Mes | |
94 | 140 | Adrian Georgescu | To use Blink, you need a SIP Account. At first start, Blink shows the _Add Account_ "window":http://icanblink.com/screenshots.phtml#enrollment that helps you configure the initial SIP Account. |
95 | 141 | Adrian Georgescu | |
96 | 140 | Adrian Georgescu | 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. After you have configured a SIP 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. A successful registration means that you are able to receive incoming calls with Blink. |
97 | 147 | Adrian Georgescu | |
98 | 141 | Adrian Georgescu | h3. Add an Existing SIP Account |
99 | 1 | Tijmen de Mes | |
100 | 147 | Adrian Georgescu | 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 entering the SIP address and password. |
101 | 1 | Tijmen de Mes | |
102 | 147 | Adrian Georgescu | Unfortunately, most SIP service providers do not tell their users what their SIP address is. Imagine your email provider giving you an account without telling you what is your email address… |
103 | 147 | Adrian Georgescu | |
104 | 147 | Adrian Georgescu | The reason for making things complicated is that SIP service providers are either un-willing or incapable of setting up their DNS and SIP infrastructure correctly and confuse users about how to configure their SIP accounts. |
105 | 147 | Adrian Georgescu | |
106 | 147 | Adrian Georgescu | Such providers typically provide separate username and server address information instead of a SIP address. The SIP address is composed by concatenating the username part and the server part format with an @ sign. Additional manual settings for the server address, transport and protocols can be made in Advanced Account Settings explained below. |
107 | 147 | Adrian Georgescu | |
108 | 147 | Adrian Georgescu | h4. The username |
109 | 147 | Adrian Georgescu | |
110 | 147 | Adrian Georgescu | Different SIP service providers may refer to this in such ways, they are all the same thing: |
111 | 147 | Adrian Georgescu | |
112 | 147 | Adrian Georgescu | * Username |
113 | 147 | Adrian Georgescu | * Account number |
114 | 147 | Adrian Georgescu | * Authentication Name |
115 | 147 | Adrian Georgescu | * Login name |
116 | 147 | Adrian Georgescu | * Phone number |
117 | 147 | Adrian Georgescu | * Extension number |
118 | 147 | Adrian Georgescu | * Number |
119 | 147 | Adrian Georgescu | |
120 | 147 | Adrian Georgescu | h4. The server |
121 | 147 | Adrian Georgescu | |
122 | 147 | Adrian Georgescu | Different SIP service providers may refer to this in such ways, they are all the same thing: |
123 | 147 | Adrian Georgescu | |
124 | 147 | Adrian Georgescu | * Server name |
125 | 147 | Adrian Georgescu | * Server address |
126 | 147 | Adrian Georgescu | * IP address |
127 | 147 | Adrian Georgescu | * Proxy address |
128 | 147 | Adrian Georgescu | * Outbound Proxy |
129 | 147 | Adrian Georgescu | * Domain |
130 | 147 | Adrian Georgescu | * Realm |
131 | 147 | Adrian Georgescu | * SIP server |
132 | 147 | Adrian Georgescu | * SIP registrar |
133 | 147 | Adrian Georgescu | |
134 | 147 | Adrian Georgescu | Concatenate the username part and the server part as follows: |
135 | 147 | Adrian Georgescu | |
136 | 147 | Adrian Georgescu | username@server |
137 | 147 | Adrian Georgescu | |
138 | 1 | Tijmen de Mes | h3. Create a Free SIP Account |
139 | 141 | Adrian Georgescu | |
140 | 147 | Adrian Georgescu | Use this option if you do not have a SIP Account, Blink can create one for you using the free service provided by SIP2SIP. All Blink features are supported by this service. |
141 | 1 | Tijmen de Mes | |
142 | 1 | Tijmen de Mes | For more information about the features of the SIP service go to "http://sip2sip.info":http://wiki.sip2sip.info |
143 | 1 | Tijmen de Mes | |
144 | 147 | Adrian Georgescu | It is recommended that you always create such account to benefit of the features beyond VoIP provided by Blink. Using a sip2sip.info account you can sync the address book between multiple instances of Blink, bridge to XMPP domains and create multi party conferences. |
145 | 1 | Tijmen de Mes | |
146 | 147 | Adrian Georgescu | h3. iCloud sync |
147 | 147 | Adrian Georgescu | |
148 | 147 | Adrian Georgescu | The default option is to sync the new account across all computers configured for the the same iCloud account. This means that any changes to any account will be synchronised across all your computers running Blink. |
149 | 147 | Adrian Georgescu | |
150 | 1 | Tijmen de Mes | h3. Advanced Account Settings |
151 | 141 | Adrian Georgescu | |
152 | 135 | Adrian Georgescu | h4. Outbound Proxy |
153 | 1 | Tijmen de Mes | |
154 | 1 | 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_. |
155 | 1 | Tijmen de Mes | |
156 | 1 | Tijmen de Mes | h2. Main Interface |
157 | 1 | Tijmen de Mes | |
158 | 1 | Tijmen de Mes | Blink presents a _Contacts driven_ "interface":http://icanblink.com/screenshots.phtml#main_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. |
159 | 1 | Tijmen de Mes | |
160 | 1 | Tijmen de Mes | The main interface can be collapsed into a "compact mode":http://icanblink.com/screenshots.phtml#collapsed_gui that hides the Contact List or dialpad. Click on the *+* Green button of the window to collapse and expand the main interface. |
161 | 138 | Tijmen de Mes | |
162 | 1 | Tijmen de Mes | Hover the mouse over the GUI elements to see a short description of their function. |
163 | 1 | Tijmen de Mes | |
164 | 147 | Adrian Georgescu | h3. SIP Account |
165 | 140 | Adrian Georgescu | |
166 | 147 | Adrian Georgescu | You can select the SIP Account used for outbound sessions in the _Accounts drop down box_ presented on the top of the main interface. |
167 | 1 | Tijmen de Mes | |
168 | 147 | Adrian Georgescu | h4. Bonjour Account |
169 | 147 | Adrian Georgescu | |
170 | 147 | Adrian Georgescu | _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. |
171 | 147 | Adrian Georgescu | |
172 | 1 | Tijmen de Mes | h3. Search Bar |
173 | 141 | Adrian Georgescu | |
174 | 115 | Adrian Georgescu | The Search bar is used for finding an existing contact or for entering a SIP address or telephone number. |
175 | 1 | Tijmen de Mes | |
176 | 1 | 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. |
177 | 1 | Tijmen de Mes | |
178 | 1 | 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_. |
179 | 1 | Tijmen de Mes | |
180 | 1 | Tijmen de Mes | Pressing enter or return after entering text in the search bar will start an audio call to that address. |
181 | 1 | Tijmen de Mes | |
182 | 1 | Tijmen de Mes | h3. Contacts List |
183 | 1 | Tijmen de Mes | |
184 | 147 | Adrian Georgescu | 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, they are sorted by name. |
185 | 1 | Tijmen de Mes | |
186 | 147 | Adrian Georgescu | * Right click on a Contact to see all possible actions for each of them. |
187 | 147 | Adrian Georgescu | * Right click on a Group to see all possible actions for each of them. |
188 | 1 | Tijmen de Mes | |
189 | 147 | Adrian Georgescu | h4. Address Book Group |
190 | 1 | Tijmen de Mes | |
191 | 1 | 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. |
192 | 1 | Tijmen de Mes | |
193 | 1 | 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. |
194 | 1 | Tijmen de Mes | |
195 | 1 | 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: |
196 | 1 | Tijmen de Mes | |
197 | 1 | Tijmen de Mes | "http://download.ag-projects .com/BlinkABPlugins/":http://download.ag-projects.com/BlinkABPlugins/ |
198 | 1 | Tijmen de Mes | |
199 | 147 | Adrian Georgescu | The plugins work with Blink Pro version only. |
200 | 1 | Tijmen de Mes | |
201 | 147 | Adrian Georgescu | h4. Bonjour Neighbours Group |
202 | 1 | Tijmen de Mes | |
203 | 1 | 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. |
204 | 1 | Tijmen de Mes | |
205 | 1 | Tijmen de Mes | Chat sessions are automatically accepted from Bonjour Neighbours. |
206 | 1 | Tijmen de Mes | |
207 | 1 | Tijmen de Mes | Audio sessions can be automatically accepted based on the correspondent setting from Account menu. |
208 | 1 | Tijmen de Mes | |
209 | 147 | Adrian Georgescu | h4. History Groups |
210 | 147 | Adrian Georgescu | |
211 | 147 | Adrian Georgescu | Special groups can be enabled to display Incoming, Missed and Outgoing Calls. Entries can be individually hidden and the period of the calls can be selected |
212 | 147 | Adrian Georgescu | |
213 | 147 | Adrian Georgescu | h4. Online Group |
214 | 147 | Adrian Georgescu | |
215 | 147 | Adrian Georgescu | This special group displays contacts that have published availability information. |
216 | 147 | Adrian Georgescu | |
217 | 123 | Tijmen de Mes | h4. Edit Contact |
218 | 128 | Tijmen de Mes | |
219 | 138 | Tijmen de Mes | You can edit a Contact by right clicking on it and select Edit menu option. _Edit Contact_ "window":http://icanblink.com/screenshots.phtml#add_contact appears. To set the _Icon for the Contact_, click on the Icon area, a file selection dialog appears. |
220 | 141 | Adrian Georgescu | |
221 | 138 | Tijmen de Mes | h4. Add Contact |
222 | 138 | Tijmen de Mes | |
223 | 147 | Adrian Georgescu | You can add a Contact to the _Contacts List_ by clicking on the groups icon button presented on the bottom left of the main interface. _Add Contact_ "window":http://icanblink.com/screenshots.phtml#add_contact appears. |
224 | 123 | Tijmen de Mes | |
225 | 134 | Tijmen de Mes | h4. Server Storage |
226 | 141 | Adrian Georgescu | |
227 | 134 | 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. If your particular SIP service does not support XCAP storage, just add a SIP account from within Blink. |
228 | 141 | Adrian Georgescu | |
229 | 141 | Adrian Georgescu | |
230 | 128 | Tijmen de Mes | h3. Start Session |
231 | 138 | Tijmen de Mes | |
232 | 128 | Tijmen de Mes | Use the buttons presented at the bottom of the main window to start a session to the current selected Contact. |
233 | 138 | Tijmen de Mes | |
234 | 138 | 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_. |
235 | 138 | Tijmen de Mes | |
236 | 147 | Adrian Georgescu | h2. Alert Panel |
237 | 134 | Tijmen de Mes | |
238 | 147 | Adrian Georgescu | Incoming session requests bring up the "Alert Panel":http://icanblink.com/screenshots.phtml#alert_panel</em>. Click on the _Accept Button_ to accept a session request. There are two options for rejecting an incoming session request: |
239 | 134 | Tijmen de Mes | |
240 | 141 | Adrian Georgescu | * 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. |
241 | 141 | Adrian Georgescu | * 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. |
242 | 141 | Adrian Georgescu | |
243 | 141 | Adrian Georgescu | 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. |
244 | 138 | Tijmen de Mes | |
245 | 138 | Tijmen de Mes | The currently selected input and output audio devices are showed for incoming Audio Call requests. |
246 | 138 | Tijmen de Mes | |
247 | 138 | Tijmen de Mes | h2. Audio Calls |
248 | 138 | Tijmen de Mes | |
249 | 138 | Tijmen de Mes | !http://icanblink.com/images/BlinkScreenshot-AudioSessions.jpg! |
250 | 138 | Tijmen de Mes | _Audio Calls_ are displayed in the lateral "drawer":http://icanblink.com/screenshots.phtml#audio_sessions attached to the main interface. |
251 | 141 | Adrian Georgescu | |
252 | 141 | Adrian Georgescu | 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. |
253 | 141 | Adrian Georgescu | |
254 | 141 | Adrian Georgescu | 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. |
255 | 141 | Adrian Georgescu | |
256 | 141 | Adrian Georgescu | 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. |
257 | 141 | Adrian Georgescu | |
258 | 141 | Adrian Georgescu | To add _Chat_ to an existing _Audio Call_, right click on the session displayed in the Audio Drawer and select an _Add Chat_ |
259 | 141 | Adrian Georgescu | |
260 | 141 | Adrian Georgescu | To mute your microphone click on the bottom right microphone icon. To un-mute click it again. |
261 | 141 | Adrian Georgescu | |
262 | 147 | Adrian Georgescu | h3. Audio Codecs |
263 | 141 | Adrian Georgescu | |
264 | 141 | Adrian Georgescu | 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. |
265 | 141 | Adrian Georgescu | |
266 | 147 | Adrian Georgescu | If you have changed the defaults or want to set the codecs manually, for high quality conversations is recommended to use OPUS, Speex, G.722 codec order and leave PCMA and PCMU enabled for compatibility reasons. |
267 | 141 | Adrian Georgescu | |
268 | 147 | Adrian Georgescu | Some details about the codecs used by Blink: |
269 | 140 | Adrian Georgescu | |
270 | 147 | Adrian Georgescu | * OPUS is the best codec choice covering full human audible spectrum and requires between 20 and 60kbit/s network bandwidth. This codec is available in Blink Pro 3.0. |
271 | 147 | Adrian Georgescu | * Speex is a high quality codec that is often built in softphones covering up to 16kHz audio spectrum and requires about 50kbit/s network bandwidth |
272 | 147 | Adrian Georgescu | * G.722 is the most compatible wideband codec supported by both software and hardware phones covering 11kHz audio spectrum and requires about 100kbit/s network bandwidth |
273 | 147 | Adrian Georgescu | * PCMA (G711A) and PCMU (G711U) are the most interoperable codecs narrowband that work with any device covering up to 4kHz audio spectrum (telephone quality) and requires about 100kbit/s network bandwidth |
274 | 147 | Adrian Georgescu | * GSM and iLBC use less bandwidth than the other codecs but they have less support in other devices and cover up to 4kHz audio spectrum and requires up to 40kbit/s network bandwidth |
275 | 147 | Adrian Georgescu | |
276 | 147 | Adrian Georgescu | h3. Best Speech Quality |
277 | 147 | Adrian Georgescu | |
278 | 147 | Adrian Georgescu | To obtain best audio quality for speech you must: |
279 | 147 | Adrian Georgescu | |
280 | 147 | Adrian Georgescu | * Use a wideband codec like Speex, G.722 or OPUS |
281 | 147 | Adrian Georgescu | * Have Acoustic Echo Cancellation enabled in Blink Audio Preferences, this will set the internal sampling rate to 32kHz covering up to 16kHz audio spectrum |
282 | 147 | Adrian Georgescu | * Enable Ambient Noise Reduction in System Sound Preferences, this will remove the fan and other low frequency noises |
283 | 147 | Adrian Georgescu | * If available bandwidth is an issue, use OPUS, Speex, G722 codecs order in Advanced RTP media preferences |
284 | 147 | Adrian Georgescu | |
285 | 147 | Adrian Georgescu | You may use any headset or no headset (speakerphone mode). |
286 | 147 | Adrian Georgescu | |
287 | 147 | Adrian Georgescu | h3. Best Studio Quality |
288 | 147 | Adrian Georgescu | |
289 | 147 | Adrian Georgescu | To obtain best possible audio quality and remove all delays and distortions of the original signals introduced by the computer software and hardware you must do the following: |
290 | 147 | Adrian Georgescu | |
291 | 147 | Adrian Georgescu | * Use a high quality headsets and microphones (low delay at least 41000 Hz sample rate) |
292 | 147 | Adrian Georgescu | * Disable Acoustic Echo Cancellation (AEC) in Blink Audio Preferences. This will disable the built-in noise reduction and echo cancellation algorithms as well as increasing the internal sampling rate to 48kHz |
293 | 147 | Adrian Georgescu | * Disable Ambient Noise Reduction in System Sound Preferences |
294 | 147 | Adrian Georgescu | * Use OPUS codec, with the AEC disabled, it will cover up to 20kHz audio spectrum |
295 | 147 | Adrian Georgescu | |
296 | 1 | Tijmen de Mes | h3. DTMF |
297 | 57 | Adrian Georgescu | |
298 | 1 | 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. |
299 | 141 | Adrian Georgescu | |
300 | 147 | Adrian Georgescu | 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). You can use other delimiter by setting it in Phone Numbers advanced section of the SIP Account. |
301 | 1 | Tijmen de Mes | |
302 | 147 | Adrian Georgescu | You can paste a string containing 0 to 9 digits, # and * from the Clipboard in the active audio call. These are then sent out as DTMF codes. |
303 | 147 | Adrian Georgescu | |
304 | 1 | Tijmen de Mes | h3. Hangup |
305 | 1 | Tijmen de Mes | |
306 | 1 | 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. |
307 | 1 | Tijmen de Mes | |
308 | 1 | Tijmen de Mes | h3. Hold/Unhold |
309 | 1 | Tijmen de Mes | |
310 | 1 | Tijmen de Mes | The shortcut key for hold and unhold of the selected session is Space. |
311 | 33 | Tijmen de Mes | |
312 | 6 | Tijmen de Mes | h3. Record |
313 | 1 | Tijmen de Mes | |
314 | 152 | Saúl Ibarra Corretgé | To record click on the _Black circle_. While recording, the circle will toggle between red and black. Recorded sessions can be found in menu _History -> Audio Recordings_. |
315 | 1 | Tijmen de Mes | |
316 | 1 | Tijmen de Mes | h3. Transfer |
317 | 1 | Tijmen de Mes | |
318 | 1 | 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. |
319 | 1 | Tijmen de Mes | |
320 | 1 | 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. |
321 | 6 | Tijmen de Mes | |
322 | 6 | Tijmen de Mes | h3. Call History |
323 | 36 | Tijmen de Mes | |
324 | 8 | 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. |
325 | 61 | Adrian Georgescu | |
326 | 1 | Tijmen de Mes | h3. Redial |
327 | 33 | Tijmen de Mes | |
328 | 6 | Tijmen de Mes | To redial the last session type Command-R, to redial a previous session select it in the History menu. |
329 | 6 | Tijmen de Mes | |
330 | 1 | Tijmen de Mes | h3. iTunes Integration |
331 | 1 | Tijmen de Mes | |
332 | 33 | Tijmen de Mes | iTunes automatically pauses playing before any _Audio Call_ pauses and resumes playing after all _Audio Calls_ have finished. This functionality does not work when Blink runs in Sandbox mode (starting with Pro version 1.9.0 and Lite version 1.7.0) due to Apple imposed restrictions. |
333 | 33 | Tijmen de Mes | |
334 | 6 | Tijmen de Mes | h3. Audio Information |
335 | 6 | Tijmen de Mes | |
336 | 6 | Tijmen de Mes | !http://icanblink.com/images/BlinkScreenshot-ICE.jpg! |
337 | 75 | Adrian Georgescu | |
338 | 75 | Adrian Georgescu | 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. |
339 | 36 | Tijmen de Mes | |
340 | 8 | 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. |
341 | 38 | Tijmen de Mes | |
342 | 22 | Tijmen de Mes | h3. Phone Numbers |
343 | 6 | Tijmen de Mes | |
344 | 1 | Tijmen de Mes | To dial a phone number, just enter the number in the _Search Box_ followed by Enter or Return key. |
345 | 33 | Tijmen de Mes | |
346 | 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). |
347 | 33 | Tijmen de Mes | |
348 | 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. |
349 | 6 | Tijmen de Mes | |
350 | 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. |
351 | 1 | Tijmen de Mes | |
352 | 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_. |
353 | 33 | Tijmen de Mes | |
354 | 1 | 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. |
355 | 33 | Tijmen de Mes | |
356 | 6 | Tijmen de Mes | h3. Voicemail |
357 | 6 | Tijmen de Mes | |
358 | 1 | 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. |
359 | 1 | Tijmen de Mes | |
360 | 6 | Tijmen de Mes | h3. Answering Machine |
361 | 88 | Adrian Georgescu | |
362 | 88 | Adrian Georgescu | 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. |
363 | 88 | Adrian Georgescu | |
364 | 88 | Adrian Georgescu | 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. |
365 | 6 | Tijmen de Mes | |
366 | 116 | Adrian Georgescu | 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. |
367 | 116 | Adrian Georgescu | |
368 | 116 | Adrian Georgescu | h3. Audio Conference |
369 | 116 | Adrian Georgescu | |
370 | 76 | Adrian Georgescu | !http://icanblink.com/images/BlinkScreenshot-AudioConference.jpg! |
371 | 120 | Adrian Georgescu | |
372 | 120 | Adrian Georgescu | Drag and drop _Audio Calls_ on top of each other to create a "Conference":http://icanblink.com/screenshots.phtml#audio_conference or use the button presented at the botton at the _Audio Drawer_ to start a _Conference_ with all active _Audio Calls_. |
373 | 120 | Adrian Georgescu | |
374 | 120 | Adrian Georgescu | Add new participants to a Conference by dragging Contacts from the _Contacts list_ onto an _Audio Call_. |
375 | 6 | Tijmen de Mes | |
376 | 124 | Adrian Georgescu | Each participant can be muted individually by pressing on the microphone symbol that appears on each conferenced session. |
377 | 124 | Adrian Georgescu | |
378 | 124 | Adrian Georgescu | To end an _Audio Conference_ drag the session out of the conference area or press the _Conference_ button again. |
379 | 124 | Adrian Georgescu | |
380 | 6 | Tijmen de Mes | There can be only one active _Audio Conference_ at any given time. |
381 | 36 | Tijmen de Mes | |
382 | 9 | Tijmen de Mes | h2. Chat Sessions |
383 | 132 | Adrian Georgescu | |
384 | 132 | Adrian Georgescu | Chat sessions work like Audio Calls in the sense that a session is established after the called party explicitly accepts the invitation and for each message there is a delivery report available. This is different to Send Message, which is a fire and forget action with no guarantees of the delivery. |
385 | 132 | Adrian Georgescu | |
386 | 132 | Adrian Georgescu | !http://icanblink.com/images/BlinkScreenshot-ServerConference.jpg! |
387 | 6 | Tijmen de Mes | |
388 | 6 | Tijmen de Mes | _Chat Sessions_ are displayed into the "Chat window":http://icanblink.com/screenshots.phtml#chat_sessions. 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. |
389 | 6 | Tijmen de Mes | |
390 | 1 | Tijmen de Mes | The lateral drawer display the active participants present in the chat session or multi-party conference. |
391 | 135 | Adrian Georgescu | |
392 | 135 | Adrian Georgescu | _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. |
393 | 135 | Adrian Georgescu | |
394 | 135 | Adrian Georgescu | You can start a _Chat Session_ by right-clicking on a _Contact_ and chose _Start Chat Session_. |
395 | 33 | Tijmen de Mes | |
396 | 9 | 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. |
397 | 1 | Tijmen de Mes | |
398 | 140 | Adrian Georgescu | Message marked with a red color background have failed to be delivered. |
399 | 140 | Adrian Georgescu | |
400 | 140 | Adrian Georgescu | To an established _Chat Session_ you can add _Audio_ or start a _Screen Sharing_ session by clicking on the buttons presented on the toolbar. |
401 | 140 | Adrian Georgescu | |
402 | 33 | Tijmen de Mes | To review previous chat conversations go to menu _History -> Chat Conversations_. |
403 | 6 | Tijmen de Mes | |
404 | 1 | Tijmen de Mes | To insert an empty line use Shift-Enter combination. |
405 | 6 | Tijmen de Mes | |
406 | 18 | 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. |
407 | 36 | Tijmen de Mes | |
408 | 147 | Adrian Georgescu | h2. Presence |
409 | 147 | Adrian Georgescu | |
410 | 147 | Adrian Georgescu | Presence is a complex topic as it requires specialized infrastructure not all SIP providers posses. See http://projects.ag-projects.com/news/15 |
411 | 147 | Adrian Georgescu | |
412 | 9 | Tijmen de Mes | h2. Short Messages |
413 | 6 | Tijmen de Mes | |
414 | 1 | 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. |
415 | 1 | Tijmen de Mes | |
416 | 1 | Tijmen de Mes | _Short Messages_ are stand-alone entities that operates in a fire and forget fashion. There is no guarantee for delivery or alerting of the final recipient. _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. |
417 | 1 | Tijmen de Mes | |
418 | 1 | Tijmen de Mes | _Short Messages_ have no end-to-end delivery report and cannot be encrypted the way Chat Sessions are. For guaranteed message delivery and encryption you must use Chat Sessions. |
419 | 1 | Tijmen de Mes | |
420 | 1 | Tijmen de Mes | A _Short Message_ cannot exceed 1300 characters on IP networks and 160 on PSTN mobile networks. |
421 | 1 | Tijmen de Mes | |
422 | 1 | Tijmen de Mes | You can send a _Short Message_ by right-clicking on a _Contact_ and chose _Send SMS_. |
423 | 1 | Tijmen de Mes | |
424 | 1 | Tijmen de Mes | Previous exchanged messages can be reviewed in the menu _Window -> Chat History_. |
425 | 1 | Tijmen de Mes | |
426 | 36 | Tijmen de Mes | h2. File Transfers |
427 | 1 | Tijmen de Mes | |
428 | 1 | Tijmen de Mes | !http://icanblink.com/images/BlinkScreenshot-FileTransfer.jpg! |
429 | 1 | Tijmen de Mes | |
430 | 38 | 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. |
431 | 1 | Tijmen de Mes | |
432 | 1 | Tijmen de Mes | _File Transfers_ are displayed in a "separate window":http://icanblink.com/screenshots.phtml#file_transfers. Each file has a progress bar attached with estimated transfer speed and remaining time. |
433 | 1 | Tijmen de Mes | |
434 | 1 | Tijmen de Mes | h2. Screen Sharing |
435 | 1 | Tijmen de Mes | |
436 | 1 | 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. |
437 | 1 | Tijmen de Mes | |
438 | 1 | 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. |
439 | 1 | Tijmen de Mes | |
440 | 1 | Tijmen de Mes | !http://icanblink.com/images/BlinkScreenshot-ScreenSharingServerSetup.jpg! |
441 | 1 | Tijmen de Mes | |
442 | 1 | Tijmen de Mes | |
443 | 1 | Tijmen de Mes | h3. Screen Sharing Party |
444 | 1 | Tijmen de Mes | |
445 | 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. |
446 | 1 | Tijmen de Mes | |
447 | 33 | Tijmen de Mes | !http://icanblink.com/images/BlinkScreenshot-ScreenSharingServerConfirmation.jpg! |
448 | 6 | Tijmen de Mes | |
449 | 6 | Tijmen de Mes | |
450 | 33 | Tijmen de Mes | h3. Screen Viewer Party |
451 | 6 | Tijmen de Mes | |
452 | 33 | Tijmen de Mes | The party asking for Screen Sharing must select the option 'Connect by Asking for Permission' when prompted by the VNC viewer. |
453 | 6 | Tijmen de Mes | |
454 | 16 | Tijmen de Mes | !http://icanblink.com/images/BlinkScreenshot-ScreenSharingClientRequest.jpg! |
455 | 6 | Tijmen de Mes | |
456 | 36 | Tijmen de Mes | |
457 | 6 | Tijmen de Mes | h2. NAT Traversal |
458 | 38 | Tijmen de Mes | |
459 | 1 | 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. |
460 | 6 | Tijmen de Mes | |
461 | 6 | Tijmen de Mes | h3. Audio |
462 | 25 | Tijmen de Mes | |
463 | 1 | 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":http://icanblink.com/screenshots.phtml#logs_ice. 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. |
464 | 6 | Tijmen de Mes | |
465 | 1 | 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":http://icanblink.com/screenshots.phtml#rtp_endpoints over the audio status information area. |
466 | 33 | Tijmen de Mes | |
467 | 6 | Tijmen de Mes | h3. IM and File Transfers |
468 | 6 | Tijmen de Mes | |
469 | 1 | Tijmen de Mes | To traverse the NAT for MSRP related sessions (Instant Messaging, File Transfer) a "MSRP relay":http://msrprelay.org 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). |
470 | 33 | Tijmen de Mes | |
471 | 1 | Tijmen de Mes | h3. Screen Sharing |
472 | 24 | Tijmen de Mes | |
473 | 6 | Tijmen de Mes | To traverse the NAT for Screen Sharing sessions a "MSRP relay":http://msrprelay.org 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). |
474 | 33 | Tijmen de Mes | |
475 | 9 | Tijmen de Mes | h2. Growl Notifications |
476 | 6 | Tijmen de Mes | |
477 | 1 | Tijmen de Mes | Growl notifications are raised for missed sessions and the Dock Icon badge is updated with the number of missed sessions. |
478 | 101 | Adrian Georgescu | |
479 | 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. |
480 | 116 | Adrian Georgescu | |
481 | 116 | Adrian Georgescu | h2. Logs |
482 | 116 | Adrian Georgescu | |
483 | 116 | Adrian Georgescu | "Logs Window":http://icanblink.com/screenshots.phtml#logs 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. |
484 | 116 | Adrian Georgescu | |
485 | 120 | Adrian Georgescu | 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. |
486 | 120 | Adrian Georgescu | |
487 | 120 | Adrian Georgescu | h2. Server Settings |
488 | 120 | Adrian Georgescu | |
489 | 120 | Adrian Georgescu | !http://icanblink.com/images/BlinkScreenshot-DND.jpg! |
490 | 124 | Adrian Georgescu | |
491 | 124 | Adrian Georgescu | 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. |
492 | 124 | Adrian Georgescu | |
493 | 124 | Adrian Georgescu | The settings are displayed in "Server Settings window":http://icanblink.com/screenshots.phtml#server_settings. 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. |
494 | 124 | Adrian Georgescu | |
495 | 124 | Adrian Georgescu | h2. Audio Devices |
496 | 124 | Adrian Georgescu | |
497 | 132 | Adrian Georgescu | 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. |
498 | 132 | Adrian Georgescu | |
499 | 132 | Adrian Georgescu | To selected a particular audio device use the menu _Audio_. |
500 | 132 | Adrian Georgescu | |
501 | 132 | Adrian Georgescu | h2. Preferences |
502 | 132 | Adrian Georgescu | |
503 | 132 | Adrian Georgescu | !http://icanblink.com/images/BlinkScreenshot-Preferences.jpg! |
504 | 132 | Adrian Georgescu | |
505 | 135 | Adrian Georgescu | To change Blink configuration go to menu _Preferences_. The Preferences "window":http://icanblink.com/screenshots.phtml#preferences appears. |
506 | 135 | Adrian Georgescu | |
507 | 135 | Adrian Georgescu | Find out more information about a particular setting by hovering the mouse over it. |
508 | 135 | Adrian Georgescu | |
509 | 135 | Adrian Georgescu | Each SIP Account has advanced options available, to reveal them click on the small triangle presented under the SIP Address. |
510 | 135 | Adrian Georgescu | |
511 | 135 | Adrian Georgescu | Blink preferences are stored in _~/Library/Application Support/Blink Pro_ folder. You can reset Blink by deleting this folder. |
512 | 140 | Adrian Georgescu | |
513 | 140 | Adrian Georgescu | Blink SIP accounts and settings are stored in _~/Library/Application Support/Blink Pro/config_ file. |
514 | 140 | Adrian Georgescu | |
515 | 140 | Adrian Georgescu | GUI preferences are stored in _~/Library/Preferences/com.agprojects.Blink.plist_ file. (e.g. size, location of the windows and other MacOSX related settings). |
516 | 140 | Adrian Georgescu | |
517 | 140 | Adrian Georgescu | 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. |
518 | 140 | Adrian Georgescu | |
519 | 140 | Adrian Georgescu | h3. Codecs |
520 | 140 | Adrian Georgescu | |
521 | 140 | Adrian Georgescu | 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_. |
522 | 147 | Adrian Georgescu | |
523 | 147 | Adrian Georgescu | h3. Open Browser on Incoming Call |
524 | 147 | Adrian Georgescu | |
525 | 147 | Adrian Georgescu | You can configure Blink Pro to automatically open a web browser on an incoming call event. For this set the _Alert URL_ in _Preferences -> Accounts -> Selected Account -> Advanced -> Web Alert_ section. |
526 | 147 | Adrian Georgescu | |
527 | 147 | Adrian Georgescu | The URL may contain the following variables that will be replaced with the actual information from the incoming session: |
528 | 147 | Adrian Georgescu | |
529 | 147 | Adrian Georgescu | * $caller_party - the SIP address of the caller party |
530 | 147 | Adrian Georgescu | * $caller_username - the username part of the SIP address of the caller party |
531 | 147 | Adrian Georgescu | * $called_party - the SIP address of the account being called |
532 | 147 | Adrian Georgescu | |
533 | 147 | Adrian Georgescu | Example: http://www.example.com?caller=$caller_party&called=$called_party |
534 | 147 | Adrian Georgescu | |
535 | 147 | Adrian Georgescu | The web page can be opened when call comes in or after it was answered. |
536 | 147 | Adrian Georgescu | |
537 | 147 | Adrian Georgescu | The web page can be opened in a Blink window or in the default web browser (check option in _Preferences -> Advanced -> GUI Settings_) |
538 | 1 | Tijmen de Mes | |
539 | 1 | Tijmen de Mes | h2. History Database |
540 | 1 | Tijmen de Mes | |
541 | 1 | Tijmen de Mes | Blink stores the history of sessions and chat messages in a Sqlite database. The location of the database is: |
542 | 1 | Tijmen de Mes | |
543 | 1 | Tijmen de Mes | <pre> |
544 | 1 | Tijmen de Mes | ~/Library/Application Support/Blink Pro/history/history.sqlite |
545 | 1 | Tijmen de Mes | </pre> |
546 | 1 | Tijmen de Mes | |
547 | 1 | Tijmen de Mes | |
548 | 1 | 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. |
549 | 1 | Tijmen de Mes | |
550 | 1 | 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: |
551 | 1 | Tijmen de Mes | |
552 | 1 | Tijmen de Mes | <pre> |
553 | 1 | Tijmen de Mes | #:~/Library/Application Support/Blink Pro/history$sqlite3 history.sqlite |
554 | 1 | Tijmen de Mes | SQLite version 3.7.7 2011-06-25 16:35:41 |
555 | 1 | Tijmen de Mes | Enter ".help" for instructions |
556 | 1 | Tijmen de Mes | Enter SQL statements terminated with a ";" |
557 | 1 | Tijmen de Mes | sqlite> select * from sessions; |
558 | 1 | Tijmen de Mes | sqlite> select * from chat_messages; |
559 | 1 | Tijmen de Mes | </pre> |
560 | 1 | Tijmen de Mes | |
561 | 1 | Tijmen de Mes | |
562 | 1 | Tijmen de Mes | h3. Restore Procedure |
563 | 1 | Tijmen de Mes | |
564 | 1 | Tijmen de Mes | Try the following in this order to solve a data corruption problem: |
565 | 1 | Tijmen de Mes | |
566 | 1 | 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. |
567 | 1 | 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. |