一、简介 目前，在SVN能够获得的最新的Bambook SDK，是0.9.5.2版，相比第一次发布的0.9.0.0版，我们有了非常多的改进与功能增强，值得费一些篇幅，来为大家介绍一下。
一、简介
目前，在SVN能够获得的最新的Bambook SDK，是0.9.5.2版，相比第一次发布的0.9.0.0版，我们有了非常多的改进与功能增强，值得费一些篇幅，来为大家介绍一下。
这次的版本，主要的特点有以下几个：
1、增加了5个函数返回值定义，完善出错处理的各种情况
2、完善了头文件的定义，比以前更加清晰了
3、允许访问Bambook中的版权书籍信息与章节信息
4、文档全面采用doxygen生成
5、通过各种方式，尽可能减少对于回调函数的使用
整个API，从原本的16个函数，增加到11大类共62个函数。
在书籍列表获取的速度方面，较之以前有10倍以上的提升。
二、论坛互动
由于各位热心的开发者积极地为SDK提意见和建议，我们的SDK才能有这么大的进步，感谢大家。下面简单摘录一些论坛里互动的情况：
foxriver：
1.api接口里，应该明确加上是__cdecl，还是__stdcall参数传递方式。
答：这个已经有了
2.api接口里，应该写明，那些是输入输出参数，就像MSDN里的IN/OUT定义。
答：这个已经有了
3.api接口里，解压/压缩没有内存序列化方法，老是要用生成临时文件来处理，这点不方便。
答：这个已经有了一组完整的函数
lifanxi：如何获知新上传的书籍的GUID?
答：新增了BambookAddPrivBookEx函数，可以获取GUID
yaer：怎么不提供书架的管理函数呀
答：目前已经提供了一组完整的版权书籍信息获取函数，还有更新书架、更新具体书籍以及删除的功能。
Fantasysoft：关于Win32版 Java SDK的问题
答：这主要是由于回调函数造成了，我们新版的SDK，已经提供了另一种等价的方式，可以绕开各种回调的问题。
Idalin：64位的到底啥时候出来啊啊啊啊啊
答：64位版本的问题，在Windows7 64位版下用C#，使用非回调方式是可以正常工作的，linux下的64位，尚未完成。
哥白不：给SDK加一个截图函数吧
答：这个我们计划在下一版本的固件支持。
qiaojie：这个C++的SDK API设计的也太不专业了
答：字符集的问题，已经新增了BambookSetCharacterEncoding来支持。
书籍大小需要固件支持，目前的计划是在BambookBookInfo结构中新增一个字段描述书籍大小，显示自有书的信息时，这个值大于0，版权书信息时，这个值等于0。
获取书籍列表的效率已经10倍提升。
Doxygen的支持已经实现。
dafu2003：请求开发人员提供VB调用定义模块
答：正在开发一个BambookCore的COM封装BambookCore.ocx，预计本周内可以放出一个测试版，这样VB和其它支持com的语言都不需要单独再移植了。
三、函数分类介绍
1、基础函数
新增BambookSetCharacterEncoding，用于设定BambookCore的 API 接收和返回的字符串使用的字符集，默认为GBK。
2、设备相关函数
新增BambookGetBookShelfChangeCount，用于返回Bambook书籍列表变更计数器，当用户通过云梯、其它应用程序或直接在设备上手工加书、删书，以及设备从服务器上同步下新书时，变更计数器会自动加 1，应用可以根据计数器的值来决定是否需要更新书架。使用BambookReplacePrivBook API可能不会影响变更计数。
3、书籍信息相关函数
新增BambookFindFirstBook、BambookFindNextBook、BambookFindBookClose、BambookGetBookInfoById、BambookGetBookChapterCount、BambookGetBookChapterInfo。用于获取书架上的各种书籍信息，不再像以前的版本，只能获取自有书信息。更可以获取每一本的章节信息，做更加细致的操作。
4、书签相关函数
新增BambookGetBookmark、BambookSetBookmark、BambookGetLastReadBook、BambookGetCurrentReadBook。用于获取及设置用户的书签信息，获得最后阅读的书籍信息以及当前正在阅读的书籍信息。
5、书籍传输相关函数
新增BambookAddPrivBookEx，以帮助开发者，在添加自有书之后，获知新增书籍的GUID号。
新增BambookGetSendPrivBookStatus、BambookGetFetchPrivBookStatus，以避免使用回调函数，在传输书籍时，将回调函数设置为NULL，然后通过以上两个函数，来获取传输的状态。
新增BambookFetchPrivBookCover，以获取自有书的封面文件。
6、版权书处理相关函数
新增BambookUpdateBook、BambookUpdateBookShelf、BambookDeleteBook，用于更新一本或书架上的全部版权书，或者删除一本版权书籍。
7、书籍分类相关函数
新增BambookCatalogCreate、BambookCatalogFree、BambookCatalogLoad、BambookCatalogSave、BambookCatalogGetCount、BambookCatalogGetItem、BambookCatalogDeleteItem、BambookCatalogRenameItem、BambookCatalogInsertItem、BambookCatalogAppendItem、BambookCatalogMoveItem、BambookCatalogGetBookCount、BambookCatalogGetBook、BambookCatalogRemoveBook、BambookCatalogInsertBook、BambookCatalogAppendBook、BambookCatalogMoveBook共17个函数，用于书籍分类的管理。在这方面，我们期待有非常方便用户的作品出现。
8、其他功能函数
新增BambookTTSPlay、BambookTTSStop，使得PC端可以调用Bambook的TTS功能，让Bambook为你说话。
9、SNB文件操作函数
新增BambookSnbOpen、BambookSnbClose、BambookSnbGetFileInfo、BambookSnbGetFirstFileInfo、BambookSnbGetNextFileInfo、BambookSnbUnpackToMemory、BambookSnbUnpackToFile共7个函数，用于处理SNB文件，其中BambookSnbUnpackToMemory函数，可以方便开发者，也实现了foxriver当初提出的需求。
四、总结
这个SDK，还处在逐步完善的过程中，期待各位朋友，能够继续提出给力的意见和建议，我们也会继续努力的满足你们的需求。
在欢迎提供建议，如有任何与手机相关问题，可以向我们发帖提问:
我们有问必答！
无限精彩的随身互联网生活，尽在PCHOME 3G.生活频道！
网友评论