Bambook大赛系列报道之十二：Bambook SDK 0.9.5.2 版介绍

3顶
1踩

2010-12-31 13:15 by 主编 ITeye管理员评论(0) 有2574人浏览

JavaEye Java 工作

一、简介

目前，在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，还处在逐步完善的过程中，期待各位朋友，能够继续提出给力的意见和建议，我们也会继续努力的满足你们的需求。

分享到：

3
顶

1
踩

评论共 0 条请登录后发表评论

发表评论

您还没有登录,请您登录后再发表评论

3顶1踩