访问和管理电话日志

电话记录API(net.rim.blackberry.api.phone.phonelogs)允许应用程序访问电话应用程序记录文件.电话呼叫记录包含每个单独电话的记录,它们分组到一个电话日志里.
注: 应用程序第一次访问电话日API时,检查一个 NoClassDefFoundError.如果系统管理员通过应用程序控制限制访问电话日志,将抛出此错误. 为获得更多信息,参看BlackBerry应用程序开发者指南 第2卷:高级 第1卷:基础.

获取一个电话日志

PhoneLogs类代表一个电话历史记录.它提供方法允许你打开,增加,删除,或交换呼叫记录.

>调用honeLogs.getInstance().

PhoneLogs _logs = PhoneLogs.getInstance

 

获取文件夹的电话呼叫数

电话日志分成2个文件夹: FOLDER_NORMAL_CALLS 和 FOLDER_MISSED_CALLS.

>调用 numberOfCalls(int).

int numberOfCalls = _logs.numberOfCalls(FOLDER_NORMAL_CALLS);

获取一个呼叫记录

你可以实例化2种类型的呼叫记录: PhoneCallLog对象,它仅可以有一个参与者,以及ConferencePhoneCallLog对象,它有2个或多个参与者.这2个对象可以使你获取或改变呼叫记录信息,例如参与者或呼叫日期.

>调用 PhoneLogs.callAt(int index, long folderID).

PhoneCallLog phoneLog = (PhoneCallLog)_logs.callAt(0);

获取一个电话参与者

PhoneCallLogID类根据电话号码标志电话里的参与者.

>调用 PhoneCallLog.getParticipant(int)或 ConferencePhoneCallLog.getParticipantAt().

PhoneCallLogID participant = phoneCallLog.getParticipant(); PhoneCallLogID participant = ConferencePhoneCallLog.getParticipant();

获取电话号码类型

PhoneCallLogID类为日志标志了电话的类型.例如,记录在地址本里的Home(家庭),Mobile(移动),Work(工作)或Fax(传真).

>调用PhoneCallLogID.getType().

String phoneType = PhoneCallLogID.getType();

创建一个呼叫记录或会议电话记录

注: PhoneCallLogID构造函数删除了电话号码里的短横以及其他非数字的字符

创建一个PhoneCallLog或ConferencePhoneCallLog对象的实例

为电话的构造函数提供日期,持续时间,参与者,以及留言参数

Date date = new Date("1000"); // date of call int duration = 60; // duration of call PhoneCallLogID caller1 = new PhoneCallLogID("555-1234"); // first participant PhoneCallLogID caller2 = new PhoneCallLogID("555-1235"); // second participant String notes = "New call."; // notes ConferencePhoneCallLog conferenceCall =     new ConferencePhoneCallLog(date, duration, PhoneLogs.FOLDER_NORMAL_CALLS,            caller1, caller2, notes);

 

将电话加入到电话日志的下一个可用的索引上

>调用PhoneLogs.addCall(CallLog call).

_logs.addCall(conferenceCall);

用新呼叫记录代替给定索引的呼叫记录

>调用 PhoneLogs.swapCall(CallLog call,int index,long folderID).

_logs.swapCall(conferenceCall, 0, FOLDER_NORMAL_CALLS);

注: swapCall()方法删除给定索引的呼叫记录..