《盛大Bambook SDK 0.9.5.2版》介绍

  【天极网数码频道】一、简介

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