=========
Demophone
=========

Download Acrobits Demophone and you can use it to explore the VoIP features and functionalities offered by Acrobits. 
If you are a developer intending to integrate Acrobits libSoftphone SDK into your projects, use Demophone to validate the capabilities of this SDK.

Demophone also demonstrates the fundamentals requirements to build a SIP application, which are as follows:

  * SIP account management
  * SIP registration management
  * Push notifications
  * VoIP mechanisms including initiating, answering, terminating calls, and handling of in-call events.

This section describes the steps to set up Demophone in Android and iOS:

.. contents::
   :local:
   :depth: 1

If you have any questions or need further assistance with the Acrobits Demophone setup, reach out to our support team for guidance. 
Enjoy exploring the Acrobits Demophone and discovering the potential of Acrobits Softphone!

----------------------------
Installing Android Demophone
----------------------------

The Demophone project for Android is available on GitHub. To download and build the Demophone:

  .. _android register a license:
  
  1.  Register an account, and then get a valid license key on **Acrobits Licensing Portal** at `saas.acrobits.net <https://saas.acrobits.net/>`_.

      Go to step 2 if you already have the license key.

  2.  Clone the Acrobits Demophone repository from GitHub using the following command:

      .. code-block:: bash
        :linenos:
    
        git clone https://github.com/acrobits/android-demophone.git

  3. Open the project in your editor.
  
  4.  Enter your license key in the project's ``gradle.properties`` file, replace the **app id** and **license key** placeholders with your license key obtained in :ref:`step 1 <android register a license>`.

      .. important::

        Demophone works only with a valid license key activation. 
    
  5.  Download and build the Demophone.
    
      Explore various settings, make test calls, and gain hands-on experience with the communication capabilities of the Demophone.

  6.  Add the push notifications.

      To enable push functionality, you need to configure push notifications for your application. The configuration process differes depending on the platform you are developing for.

      Go to the :ref:`Android Push notifications` section for the detailed setup instructions.

----------------------------------
Installing iOS Demophone for Swift
----------------------------------

The Demophone project for iOS is available on GitHub. To download and build the Swift-based libSoftphone Demophone:

  .. _ios swift register a license:
  
  1.  Register an account, and then get a valid license key on **Acrobits Licensing Portal** at `saas.acrobits.net <https://saas.acrobits.net/>`_.

      Go to step 2 if you already have the license key.

  2.  Clone the Demophone repository from GitHub using the following command:

      .. code-block:: bash
        :linenos:
    
        git clone https://github.com/acrobits/ios-demophone.git

  3.  Open the project in your editor.

  4.  Add the Swift package.
  
  5.  Enter your license key obtained in :ref:`step 1 <ios swift register a license>` to the **provisioning.xml** file.

    .. important::

        Demophone works only with a valid license key activation. 

  6.  Download and build the Demophone.
    
      Explore various settings, make test calls, and gain hands-on experience with the communication capabilities of the Demophone.

  7.  Add the push notifications.

      To enable push functionality, you need to configure push notifications for your application. The configuration process differes depending on the platform you are developing for.

      Go to the :ref:`iOS Push notifications` section for the detailed setup instructions.

----------------------------------------
Installing iOS Demophone for Objective-C
----------------------------------------

The Demophone project for iOS is available on GitHub. To download and build the Objective-C-based libSoftphone Demophone:

  .. _ios objc register a license:
  
  1.  Register an account, and then get a valid license key on **Acrobits Licensing Portal** at `saas.acrobits.net <https://saas.acrobits.net/>`_.

      Go to step 2 if you already have the license key.

  2.  Clone the Demophone repository from GitHub using the following command:

      .. code-block:: bash
        :linenos:
    
        git clone https://github.com/acrobits/ios-demophone.git

  3. To download and set up the SDK:
        
    a.  Go to `dist.acrobits.net/saas/dl.php <https://dist.acrobits.net/saas/dl.php>`_.
    b.  Under **FILES**, download the latest SDK file.
    
        The SDK file name is with this convention ``libsoftphone_SaaS-x.x.xx.zip``. Choose the one with the latest date.

    c.  Extract the zipped file and then open to see a **Frameworks** folder.
        
        The **Frameworks** folder has all the relevant frameworks.
        
    d.  Copy and place the **Frameworks** folder under the same directory where the **demophone-objc** folder is located.
    e.  Select **Clean and Build** for the project.
    f.  Select **Run**.

  4.  Open the project in your editor.

  5.  Enter your license key obtained in :ref:`step 1 <ios objc register a license>` to the **provisioning.xml** file.

    .. important::

        Demophone works only with a valid license key activation. 

  6.  Download and build the Demophone.
    
      Explore various settings, make test calls, and gain hands-on experience with the communication capabilities of the Demophone.

  7.  Add the push notifications.

      To enable push functionality, you need to configure push notifications for your application. The configuration process differes depending on the platform you are developing for.

      Go to the :ref:`iOS Push notifications` section for the detailed setup instructions.