CoreTelephony框架的简单使用

昨晚看一篇文章时看到了私有API这个词，貌似开发者对私有API的使用很反感，可惜我连私有API是什么都不知道（惭愧惭愧），于是果断百度谷歌，以下是Stackoverflow中关于Private Frameworks的一个解释：

Private frameworks are frameworks which you are not allowed to use. They are not expected to be used outside of Apple, hence "Private". They are often lower-level libraries which may "break" the system if not used correctly. (But the frameworks have to exist because Apple's apps and public frameworks do use the private frameworks.) 

Since the private frameworks are not for public use, Apple doesn't need to give any headers or documentations away.

If you're writing for AppStore, you should not use private frameworks (unless you're from Apple). The system will immediately reject your app even before the review process begins. 

(On the other hand, for jailbroken platforms you're free to use any frameworks. Even so, the APIs of private frameworks is unstable, that you should avoid them if possible. 

There is an ongoing effort to document these private frameworks and API inhttp://iphonedevwiki.net/index.php/Main_Page.)

私有框架我们可以在SDK目录中找到，详细目录如下：

/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS7.0.sdk/System/Library/PrivateFrameworks/

一大堆，里面就提供了私有API，这些私有框架苹果并不提倡我们使用，私有框架中没有给出头文件（好像可以导出）而且也没有官方的文档说明，一旦app中使用了私有API，那么审核将无法通过（但是据说Google的GoogleVoice使用了私有API并且通过了审核，背后发生了什么我们不得而知）。但是私有API的功能貌似非常强大，更加是越狱开发的必备工具。

于是我很好奇地想玩下私有API，搜到了一个CoreTelephony框架，貌似在iOS 6以前该框架是私有框架，但来到iOS 7该框架绝对是个公开的框架了，因为我在PrivateFrameworks目录下找不到该框架，相反在上一层中的Frameworks目录下找到了该框架：

Apple官网也给出了该框架的文档：Core Telephony Framework Reference

无论如何，先试玩下这个框架。

参考网上的一篇文章（10年写的，那个时候CoreTelephony框架应该还是个私有框架吧），简单使用了一下该框架，用来输出手机的运营商信息和简单的通话信息。

首先要导入CoreTelephony框架：

// 首先导入CoreTelephony框架@import CoreTelephony;

这里使用了@import关键字，所以要确保Enable Modules选项已经打开：

然后声明一个CTCallCenter变量，该变量非strong属性，所以不会导致在代码块中使用时形成retain cycle的问题：

@interface ViewController () {    CTCallCenter *center_; // 为了避免形成retain cycle而声明的一个变量，指向接收通话中心对象}@end

接着编写获取运营商信息的方法：

- (void)getCarrierInfo {    // 获取运营商信息    CTTelephonyNetworkInfo *info = [[CTTelephonyNetworkInfo alloc] init];    CTCarrier *carrier = info.subscriberCellularProvider;    NSLog(@"carrier:%@", [carrier description]);        // 如果运营商变化将更新运营商输出    info.subscriberCellularProviderDidUpdateNotifier = ^(CTCarrier *carrier) {        NSLog(@"carrier:%@", [carrier description]);    };        // 输出手机的数据业务信息    NSLog(@"Radio Access Technology:%@", info.currentRadioAccessTechnology);}

最后在viewDidLoad方法中注册通话事件的处理代码块：

- (void)viewDidLoad{    [super viewDidLoad];        // 获取并输出手机的运营商信息    [self getCarrierInfo];        // 监控通话信息    CTCallCenter *center = [[CTCallCenter alloc] init];    center_ = center;    center.callEventHandler = ^(CTCall *call) {        NSSet *curCalls = center_.currentCalls;        NSLog(@"current calls:%@", curCalls);        NSLog(@"call:%@", [call description]);    };}

这里有一点比较奇怪，如果我不使用CTCallCenter的currentCalls属性，那么将无法输出代码块中的参数call的信息。

代码很简单，功能也很有限，下面真机调试下（模拟器输出为null，这个不用解释了吧）。

启动程序，控制台输出信息如下：

2014-02-15 14:48:31.711 GetMyPhone[762:60b] carrier:CTCarrier (0x166682f0) {Carrier name: [中国移动]Mobile Country Code: [460]Mobile Network Code:[07]ISO Country Code:[cn]Allows VOIP? [YES]}2014-02-15 14:48:31.713 GetMyPhone[762:60b] Radio Access Technology:CTRadioAccessTechnologyEdge

Radion Acess Technology的值包括：

/* * Radio Access Technology values */CORETELEPHONY_EXTERN NSString * const CTRadioAccessTechnologyGPRS          __OSX_AVAILABLE_STARTING(__MAC_NA,__IPHONE_7_0);CORETELEPHONY_EXTERN NSString * const CTRadioAccessTechnologyEdge          __OSX_AVAILABLE_STARTING(__MAC_NA,__IPHONE_7_0);CORETELEPHONY_EXTERN NSString * const CTRadioAccessTechnologyWCDMA         __OSX_AVAILABLE_STARTING(__MAC_NA,__IPHONE_7_0);CORETELEPHONY_EXTERN NSString * const CTRadioAccessTechnologyHSDPA         __OSX_AVAILABLE_STARTING(__MAC_NA,__IPHONE_7_0);CORETELEPHONY_EXTERN NSString * const CTRadioAccessTechnologyHSUPA         __OSX_AVAILABLE_STARTING(__MAC_NA,__IPHONE_7_0);CORETELEPHONY_EXTERN NSString * const CTRadioAccessTechnologyCDMA1x        __OSX_AVAILABLE_STARTING(__MAC_NA,__IPHONE_7_0);CORETELEPHONY_EXTERN NSString * const CTRadioAccessTechnologyCDMAEVDORev0  __OSX_AVAILABLE_STARTING(__MAC_NA,__IPHONE_7_0);CORETELEPHONY_EXTERN NSString * const CTRadioAccessTechnologyCDMAEVDORevA  __OSX_AVAILABLE_STARTING(__MAC_NA,__IPHONE_7_0);CORETELEPHONY_EXTERN NSString * const CTRadioAccessTechnologyCDMAEVDORevB  __OSX_AVAILABLE_STARTING(__MAC_NA,__IPHONE_7_0);CORETELEPHONY_EXTERN NSString * const CTRadioAccessTechnologyeHRPD         __OSX_AVAILABLE_STARTING(__MAC_NA,__IPHONE_7_0);CORETELEPHONY_EXTERN NSString * const CTRadioAccessTechnologyLTE           __OSX_AVAILABLE_STARTING(__MAC_NA,__IPHONE_7_0);

以上信息指的是手机的数据业务吧，我的是Edge，不知道是什么，搜了一下：

GPRS：（General Packet Radio Service)，它是GSM移动电话用户可用的一种移动数据业务, 是GSM的技术升级，属于2.5G，简单讲就是网速更快了。 

EDGE：（Enhanced Data Rate for GSM Evolution），即增强型数据速率GSM演进技术。 是GPRS的技术升级，属于2.75G。 

EDGE和GPRS同属于从GSM到3G的过渡技术。

之后另外拿台手机打入本机，并且Descline，输出如下：

2014-02-15 14:48:38.727 GetMyPhone[762:1803] current calls:{(    CTCall (0x16620620) {callState: [CTCallStateIncoming]Call ID: [E3E1D27E-3644-4BE3-9748-5B835925EDC2]})}2014-02-15 14:48:38.739 GetMyPhone[762:1803] call:CTCall (0x16620620) {callState: [CTCallStateIncoming]Call ID: [E3E1D27E-3644-4BE3-9748-5B835925EDC2]}2014-02-15 14:48:42.684 GetMyPhone[762:1803] current calls:(null)2014-02-15 14:48:42.710 GetMyPhone[762:1803] call:CTCall (0x165267e0) {callState: [CTCallStateDisconnected]Call ID: [E3E1D27E-3644-4BE3-9748-5B835925EDC2]}

可以看到通话状态由Incoming到Disconnected，在断开通话时current calls变为nil了。

那么该app可不可以在后台监控通话事件呢？答案是不行。

1.你可以让手机进入后台，然后用另外一台手机打入本机，控制台没有关于通话信息的输出。

2.你可以尝试用本机打电话出去，此时我们调用了系统的Phone程序，Demo程序已经进入了后台，无法监听到任何通话信息。

3.用别的手机打入本机，选择Answer（话费要钱，调试完不要忘记断开通话啊），此时系统将调用Phone程序，Demo程序进入后台，所以在控制台输出中我们找不到Disconnected的通知：

2014-02-15 14:47:07.946 GetMyPhone[751:3407] current calls:{(    CTCall (0x16642820) {callState: [CTCallStateIncoming]Call ID: [140AF363-434D-41EE-BDC9-4730F5865724]})}2014-02-15 14:47:07.959 GetMyPhone[751:3407] call:CTCall (0x16642820) {callState: [CTCallStateIncoming]Call ID: [140AF363-434D-41EE-BDC9-4730F5865724]}2014-02-15 14:47:15.836 GetMyPhone[751:1807] current calls:{(    CTCall (0x16563140) {callState: [CTCallStateConnected]Call ID: [140AF363-434D-41EE-BDC9-4730F5865724]})}2014-02-15 14:47:15.855 GetMyPhone[751:1807] call:CTCall (0x16563140) {callState: [CTCallStateConnected]Call ID: [140AF363-434D-41EE-BDC9-4730F5865724]}

本文简单使用了一下CoreTelephony这个曾经的私有框架，等以后真正用上私有API时再写文章做下笔记吧。

Demo已上传：点此进入下载页

参考资料：

Core Telephony

What are Private FrameWorks and how will we use them?

Block的Retain Cycle的解决方法

@import vs #import - iOS 7

private framework使用（该文章给出了私有框架的路径）