Before starting to use the client you should configure your identity and the network settings. This short guide explain how to do this.
At the home screen, go to Options->Identity to open the Identity screen.
Display Name: Your nickname. Useless in this beta version.
IMS Public Identity (IMPU): As its name says, it’s your public visible identifier where you are willing to receive calls or any demands. An IMPU could be either a SIP or tel URI (e.g. tel:+33100000 or sip:firstname.lastname@example.org).
For those using IMSDroid as a basic SIP client, the IMPU should coincide with their SIP URI (a.k.a SIP address).
IMS Private Identity (IMPI): The IMPI is a unique identifier assigned to a user (or UE) by the home network. It could be either a SIP URI (e.g. sip:email@example.com), a tel URI (e.g. tel:+33100000) or any alphanumeric string (e.g. firstname.lastname@example.org or 812345).
For those using IMSDroid as a basic SIP client, the IMPI should coincide with their authentication name. If you don't know what is your IMPI, then fill the field with your SIP address as above.
Password: Your password.
Realm: The realm is the name of the domain to authenticate to. It should be a valid SIP URI (e.g. sip:fonosip.com).
3GPP Early IMS Security: If you are not using an IMS server you should use this option to disable some heavy IMS authentication procedures.
At the home screen, go to Options->Network to open the Network screen.
Enable WiFi: To enable WiFi.
Enable 3G/2.G: To enable 3G (e.g. UMTS) and 2.5G (e.g. EDGE) networks.
Proxy-CSCF Host: This is the IP address or FQDN (Fully-Qualified Domain Name) of your SIP server or outbound proxy (e.g. 220.127.116.11 or example.com).
Proxy-CSCF Port: The port associated to the proxy host. Should be 5060.
Transport: The transport type (TCP or UDP) to use.
Proxy-CSCF Discovery: Should be None.
Enable SigComp: Will enable Signaling Compression. Only check if your server support this feature. Should not be checked.
Return to the home screen and click on Sign In item to connect to your SIP server.
If the connection succeed, you will have new items in the home screen (see below) and a green notification icon will be added in the status bar.
This beta version (v1.0.0) already supports both audio and video calls.
- Supported Audio Codecs: AMR-NB, GSM, PCMA, PCMU, Speex-NB
- Supported Video codecs: H264, Theora, H.263, H.263-1998, H.261
To choose which audio/video codecs to enable/disable you should go to Options->Codecs screen page as shown below.
To have decent video quality, you should only check Theora or H.264 codecs. However, these codecs require at least a 600MHz processor.
If you are using an old Android device (e.g. Android G1), then you should only select H.263 and H.263+.
Of course the remote party should also support the same codecs.
If you are using one-way video services (e.g. VoD, IPTV) you can use any device because the video decoding process require less CPU resources.
You can place a call from the dialer, address book or the history screen.
From the Dialer¶
The dialer is accessible from the home screen ().
The dialer screen is shown below.
You can enter any phone number (e.g. '+33100000000' or '0600000000'), SIP URI (e.g. 'sip:email@example.com'). If the SIP Uri is incomplete (e.g. 'bob') the application will automatically append the scheme ('sip:') and domain name('@fonosip.com') before placing the call.
If you put a telephone number with 'tel:' prefix, the client will try to map it to a SIP URI using ENUM protocol.
From the Dialer screen you can click on:
to make audio call.
to make audio/video call.
to send a SIP MESSAGE (Short IM).
From the History¶
All incoming, outgoing and missed calls and message will be logged in the history screen.
To redial a number from the history screen, click on the history icon () from the home screen.
| || |
|History Screen ||History Screen with context menu |
The context menu is opened when you select an entry and make a long click.
From the Address Book¶
In this beta version the address book feature is not fully implemented.
To add a new contact, open the contact screen by clicking on the contact item () from the home screen.
At the Contacts screen click on the Android 'menu' button to add a new contact.
Audio/Video calls can be made as explained above (History Screen).
In Call Screen¶
Once the call is placed a new screen (In Call Screen) will be automatically opened and a notification icon will be added in the status bar (). As long as you are in call this icon will remain in the status bar. This icon will allow you to reopen the 'In Call Screen'. The Audio stream will continue even if you leave this screen or the application but the video stream will be stopped (restarted when you come back).
As you can remark, your preview image only contains a white box. It's because you have to explicitly start the outgoing video stream.
|In Call Screen|
This is done by clicking on the Android menu button and selecting item.
item will be used to stop the video.
| || |
|In Call Screen with context menu ||In Call Screen with full-duplex video |