Linphone how to migrate to their own projects

I own integrated Demo & SDK source path

Download the latest version of the SDK

Amway rivers and lakes brother at first Jane book before the start of the original are shining this step by step, groping http://www.jianshu.com/p/2ba2d4aa168e

Update ipv6

See end of text

Text begins.
In many scenes, our App will use VOIP to call, although the major telecommunications companies have launched their own SDK, compared Linphone, they are more friendly to developers (reflected in a more timely technical support, rich development document), but sometimes, under certain requirements, and only took Linphone SDK, bite the bullet up. And I was to achieve pure SIP calls, and customer demand, it is carried out for the purpose of Linphone SDK integration, development, this article is a record for future read, and second, in order to allow subsequent developers less some jumping pit, in vain waste time.

First we have to download an important Linphone Demo , need CSDN 2 points, if not you can ask me to leave a message. You can only run on a real machine.

1. Preparations

1.1 Adding dependency libraries

To support the new ipv6 SDK, you need to add VideoToolBox.framework

1.2 configuration

1.3 http request settings

From iOS9 beginning, Apple recommends that all network requests have to use https, if you want to keep the original http request method, developers need to modify the configuration file (Note: xcode7.0 the following modification is not required), the file name in the project the following clip Supporting files folder, locate and select the (project name) lnfo.pList Add key in the right window appears: NSAppTransportSecurity, add the following items: NSAllowsArbitraryLoads, set the Boolean value is YES, this platform SDK to support internal project http request method.

1.4 running in the background

General iOS program into the background after the system is suspended, it will stop the execution, can not do anything.

从iOS4开始，苹果增加了特性，很好的支持了语音通话功能：

苹果支持应用可以在后台播放和录制声音；

苹果支持网络托管，保证应用在后台时，还能保持网络连接，能接收到来电；

应用可以设置一个超时处理，程序在后台运行时，周期性地唤醒应用，保证客户端和服务器有长连接，使网络不断开。

SDK封装了这些特性，保证了在iOS平台上，有很好的语音通话体验。
开发者需要修改配置文件，这样iOS工程才能支持这些特性。

在工程名的文件夹下面的Supporting Files文件夹中找到并且选择(工程名)lnfo.pList在右边出现的窗口中添加Key: Required background modes，在下面添加两个项：App plays audio和App provides Voice over IP services。(注：如果只是使用发起通话，并无接听功能，则不需要添加App provides Voice over IP services)

2. 导入Linphone SDK

上面工作做完后就可以开始导入Linphone SDK了。

2.1 首先再回到这个熟悉的页面，点击Add Other

2.2 找到下载好的sdk目录，把所有.a库都选择，如下图。

2.3 查看是否关联

Build Settings搜索 Search Paths，在下列两个选项下观察是否已经关联，如图

顺带说一下这个libxml2，大多数时候是不需要的，如果报一些莫名其妙的错误不妨将其导入，且在Build Phases里添加相应库libxml2.tbd

2.4 编译

如果出现了形如“file not found”的错误提示，回到第三步，检查头文件、静态库是否关联成功

3. 功能实现

这一部分可以参考CSDN Linphone Demo（以下统称为CDemo），也可以直接下载我在github代码里的SDK代码部分，更为直接。

3.1 初始化

需要关注CSDN Demo里的主要功能类LinphoneManage.m
实现如下方法即可


 @author Jozo, 16-06-30 11:06:18
 
 初始化
 */
- (void)startUCSphone {
    
    [[LinphoneManager instance] startLibLinphone];
    [UCSIPCCSDKLog saveDemoLogInfo:@"初始化成功" withDetail:nil];
    
}

3.2 注册

注册方法在CDemo的manager类里没有直接的体现，值得注意的是我标注“三个大坑”的地方，如果有需要用到displayName这个参数的同学一定要注意了，设置好displayName后一定要通过linphone_address_as_string(..)方法再次获取identity，然后再调用linphone_proxy_config_set_identity(proxyCfg, identity);将新的identity设置到设置文件中，因为我开始没理清这个proxyCfg的实现逻辑，始终没注意到这一步，还有就是使用了另一个函数linphone_address_as_string_uri_only的误导，是误导,后者获取到的仅有“sip:”以及之后的那个字符串，并不会将昵称也带进去传入proxyCfg，导致displayName一直设置不成功，掉坑三日终于在某个狂风乱作的下午解决此bug，导致天气都变得风和日丽起来。

注：以下账号、密码、IP、端口需要自己注册。


 @author Jozo, 16-06-30 11:06:13
 
 登陆
 
大专栏  怎样将Linphone移植到自己的项目s="line"> @param username  用户名
 @param password  密码
 @param displayName  昵称
 @param domain    域名或IP
 @param port      端口
 @param transport 连接方式

 */
- (BOOL)addProxyConfig:(NSString*)username password:(NSString*)password displayName:(NSString *)displayName domain:(NSString*)domain port:(NSString *)port withTransport:(NSString*)transport {
    LinphoneCore* lc = [LinphoneManager getLc];
    
    if (lc == nil) {
        [self startUCSphone];
        lc = [LinphoneManager getLc];
    }
    
    LinphoneProxyConfig* proxyCfg = linphone_core_create_proxy_config(lc);
    NSString* server_address = domain;
    
    char normalizedUserName[256];
    linphone_proxy_config_normalize_number(proxyCfg, [username cStringUsingEncoding:[NSString defaultCStringEncoding]], normalizedUserName, sizeof(normalizedUserName));
    
    
    const char *identity = [[NSString stringWithFormat:@"sip:%@@%@", username, domain] cStringUsingEncoding:NSUTF8StringEncoding];
    
    LinphoneAddress* linphoneAddress = linphone_address_new(identity);
    linphone_address_set_username(linphoneAddress, normalizedUserName);
    if (displayName && displayName.length != 0) {
        linphone_address_set_display_name(linphoneAddress, (displayName.length ? displayName.UTF8String : NULL));
    }
    if( domain && [domain length] != 0) {
        if( transport != nil ){
            server_address = [NSString stringWithFormat:@"%@:%@;transport=%@", server_address, port, [transport lowercaseString]];
        }
        // when the domain is specified (for external login), take it as the server address
        linphone_proxy_config_set_server_addr(proxyCfg, [server_address UTF8String]);
        linphone_address_set_domain(linphoneAddress, [domain UTF8String]);
        
    }
    
    // 添加了昵称后的identity(此处是大坑！大坑！大坑)
    identity = linphone_address_as_string(linphoneAddress);
    
    linphone_address_destroy(linphoneAddress);
    
    LinphoneAuthInfo* info = linphone_auth_info_new([username UTF8String]
                                                    , NULL, [password UTF8String]
                                                    , NULL
                                                    , linphone_proxy_config_get_realm(proxyCfg)
                                                    ,linphone_proxy_config_get_domain(proxyCfg));
    
    [self setDefaultSettings:proxyCfg];
    
    [self clearProxyConfig];
    
    linphone_proxy_config_set_identity(proxyCfg, identity);
    linphone_proxy_config_set_expires(proxyCfg, 2000);
    linphone_proxy_config_enable_register(proxyCfg, true);
    linphone_core_add_auth_info(lc, info);
    linphone_core_add_proxy_config(lc, proxyCfg);
    linphone_core_set_default_proxy_config(lc, proxyCfg);
    ms_free(identity);

    
    [UCSIPCCSDKLog saveDemoLogInfo:@"登陆信息配置成功" withDetail:[NSString stringWithFormat:@"username:%@,npassword:%@,ndisplayName:%@ndomain:%@,nport:%@ntransport:%@", username, password, displayName, domain, port, transport]];
    

    
    return TRUE;
}

3.3 拨打电话

接着简单的调用如下方法即可进行SIP呼叫。`

1	[[LinphoneManager instance] call:address displayName:displayName transfer:transfer];

值得注意的是，呼叫状态、登陆状态的回调都是通过通知来传递的，所以要想获取这些回调，可以监听这些回调，具体通知名在LinphoneManager.h里，形如“kLinphoneCallUpdate”，也可以像我一样，在LinphoneManager.m的各个回调处，将相应的通知改为自己想要设置的代理方法，并设置好代理，可以看我在Github Demo里的LinphoneManager.m处如下方法里的实现。

1
2
3

- (void)onRegister:(LinphoneCore *)lc cfg:(LinphoneProxyConfig*) cfg state:(LinphoneRegistrationState) state message:(const char*) message;

- (void)onCall:(LinphoneCall*)call StateChanged:(LinphoneCallState)state withMessage:(const char *)message;

4. 为支持ipv 6而导入新版Linphone SDK

旧版SDK不支持ipv6，更后到新版后linphonecore.h增加了一个新的宏LINPHONE_DEPRECATED，有此标记表示该函数已弃用，而我由于只用到了SIP电话，故直接替换sdk后只报了如下错误，下面一一解决

4.1 替换LINPHONE_DEPRECATED标识的函数

弃用的函数都有对应的新函数，在注释里可以轻易找到


 * @return the default proxy configuration, that is the one used to determine the current identity.
 * @deprecated Use linphone_core_get_default_proxy_config() instead.
**/
LINPHONE_PUBLIC LINPHONE_DEPRECATED int linphone_core_get_default_proxy(LinphoneCore *lc, LinphoneProxyConfig **config);


 * @ingroup media_parameters
 * Get default call parameters reflecting current linphone core configuration
 * @param lc LinphoneCore object
 * @return  LinphoneCallParams
 * @deprecated use linphone_core_create_call_params()
 */
LINPHONE_PUBLIC LINPHONE_DEPRECATED LinphoneCallParams *linphone_core_create_default_call_parameters(LinphoneCore *lc);

4.2 Delete abandoned library initialization

In the figure above mention now "_libmsilbc_init", referenced from: .. This is because the new version linphone sdk lib folder in the library .a change, there is a decrease in deleted, and libmsilbc.a were removed, it is to be in LinphoneManager createLinphoneCore]Lane deletedlibmsilbc_init();

4.3 The third bug is caused by an error on two

1,2 resolved, will naturally solve 3.

Basic is so much, in fact, in retrospect, is not particularly complicated, but when you first get started do not have much information on the Internet documents, mostly on my own, as well as the meager blog slowly comprehend is very bitter, I hope you less detours it.

For any other trouble can email me [email protected]

That’s all, thank you.