/VialerSIPLib

An Objective-c wrapper for PJSIP

Primary LanguageObjective-CGNU General Public License v3.0GPL-3.0

VialerSIPLib

CI Status Version License Platform

We've created a better wrapper for the PJSIP library.

Why did we make a new wrapper for the PJSIP library? Previous implementations we found (Gossip, Swig & Telephone) had a primary goal to keep the SIP connection and registration up to date. Because a mobile app is switching networks and connections all the time, it is not possible to keep the SIP registration correct. Since iOS 8, Apple strongly advised to start using VoIP push notification and not to try keep the connection alive all the time. And because we think adjusting one of the libraries wouldn’t do the trick, we decided to make our own wrapper. This library is created as a cocoapod to make inclusion in your app dead simple. Many thanks and credits go to the creators of PJSIP and the people who created the wrappers around it. But now it is our turn. And we would like your help. We try to make the wrapper as general as possible, so please use it the way you want to use it. If you think you can help improving this library, please send us an email or create a pull-request. We will respond asap.

We use this library in our own app, Vialer. To make sure we always have a correct version of PJSIP, we created our own cocoapod named Vialer-pjsip-iOS.

Status

In active development.

Usage

Requirements

  • Cocoapods
  • iOS 9.0 or greater

Installation

VialerSIPLib is available through CocoaPods. To install it, simply add the following line to your Podfile:

    platform :ios, '9.0'
    pod 'VialerSIPLib'

Running

To run the example project, clone the repo, and run pod install from the Example directory first.

Rename Keys.sample.swift from the Example/VialerSIPLib directory to Keys.swift and add your personal credentials. You can now run a the library with a very basic UI.

For more information on how to get started, read the Getting Started Guide.

Documentation

We try to be as extensive as possible for our documentation. Your can find them here. Or check out our CocoaDocs.

Roadmap

We want to be clear on what we will build and what progress we're making. Please check our goals and roadmap.

Contributing

See the CONTRIBUTING.md file on how to contribute to this project.

We would really like to have you involved in the project. Please contact us at vialersiplib@wearespindle.com, or create a pull request.

Contributors

See the Credits file for a list of contributors to the project.

Devhouse Spindle, vialersiplib@wearespindle.com

For more credits & contributions, please see Credits & Documentation.

Roadmap

Changelog

The changelog can be found in the CHANGELOG.md file.

In progress

  • Stability for incoming phonecalls
  • Overall stability in the app
  • Refactor to Swift here code is touched

Future

  • Secure calling
  • Videocalling

Get in touch with a developer

If you want to report an issue see the CONTRIBUTING.md file for more info.

We will be happy to answer your other questions at vialersiplib@wearespindle.com or insert alias.

License

VialerSIPLib is made available under the GNU General Public License v3.0 license. See the LICENSE file for more info.