手机探索者开发实录—MobileExplorer接口

手机探索者开发实录—MobileExplorer接口

转载时请注明出处和作者联系方式
作者联系方式：李先静 <xianjimli at hotmail dot com>

MobileExplorer接口是手机探索者(mobile explorer)的一个重要部件，它提供了对手机操作的基本抽象:

2. typedefMeRet(*MobileExplorerGetTypeInfoFunc)(MobileExplorer*thiz,MeType*type);
3. typedefMeRet(*MobileExplorerGetDeviceInfoFunc)(MobileExplorer*thiz,MeDeviceInfo*info);
4. typedefMeRet(*MobileExplorerAuthFunc)(MobileExplorer*thiz,constchar*user,constchar*passwd);
5. typedefMeRet(*MobileExplorerDelObjectsFunc)(MobileExplorer*thiz,MePath*path);
6. typedefMeRet(*MobileExplorerAddObjectsFunc)(MobileExplorer*thiz,MeObjects*objs);
7. typedefMeRet(*MobileExplorerUpdateObjectsFunc)(MobileExplorer*thiz,MeObjects*objs);
8. typedefMeRet(*MobileExplorerGetObjectsFunc)(MobileExplorer*thiz,MePath*path,MeObjects*hdrs);
9. typedefMeRet(*MobileExplorerGetObjectsHdrFunc)(MobileExplorer*thiz,MePath*path,MeObjectsHdr*h
10. drs);
11. typedefMeRet(*MobileExplorerIMECommitFunc)(MobileExplorer*thiz,constchar*text);
12. typedefMeRet(*MobileExplorerClipboardSetDataFunc)(MobileExplorer*thiz,MeData*data);
13. typedefMeRet(*MobileExplorerClipboardGetDataFunc)(MobileExplorer*thiz,MeData*data);
14. typedefMeRet(*MobileExplorerRegListenerFunc)(MobileExplorer*thiz,MobileExplorerEvent*listener);
15. typedefMeRet(*MobileExplorerDestroyFunc)(MobileExplorer*thiz);
17. struct_MobileExplorer
18. {
19. MobileExplorerGetTypeInfoFuncget_type_info;
20. MobileExplorerGetDeviceInfoFuncget_device_info;
21. MobileExplorerAuthFuncauth;
22. MobileExplorerDelObjectsFuncdel_objects;
23. MobileExplorerAddObjectsFuncadd_objects;
24. MobileExplorerUpdateObjectsFuncupdate_objects;
25. MobileExplorerGetObjectsFuncget_objects;
26. MobileExplorerGetObjectsHdrFuncget_objectshdr;
27. MobileExplorerIMECommitFuncime_commit;
28. MobileExplorerClipboardSetDataFuncclipboard_set_data;
29. MobileExplorerClipboardGetDataFuncclipboard_get_data;
30. MobileExplorerRegListenerFuncreg_listener;
31. MobileExplorerDestroyFuncdestroy;
33. charpriv[0];
34. };

1. get_type_info 数据类型(包括mimetype)是以整数类型传递，如果需要更多关于某个类型的信息，需要调用这个函数得到指定类型的详细信息。
2. get_device_info 用于查询设备信息，包括版本号，硬件配置，和对MobileExplorer接口的支持。
3. auth 鉴权，目前的功能相当于login。
4. del_objects 删除对象，对象包括文件对象和数据库对象，这里MePath是对象的标识，MePath可以代表单个对象，也可以代表一个对象集合。
5. add_objects 向手机中增加对象。
6. update_objects 更新手机中已有的对象。
7. get_objects 获取指定的对象。
8. get_objectshdr 获取指定对象的信息，不包括对象的数据。
9. ime_commit PC输入法向手机提交字符串。
10. clipboard_set_data 设置手机剪切板中的数据。
11. clipboard_get_data 获取手机剪切板中的数据。
12. reg_listener 注册手机中的事件，事件包括来电，新短信，新邮件，新彩信，提醒，剪切板类型变化，电量变化，睡眠和唤醒等等。
13. destroy 销毁对象。

~~end~~