《盛大Bambook SDK 0.9.5.2版》介紹

  【天極網(wǎng)數(shù)碼頻道】一、簡介

  目前，在SVN能夠獲得的最新的Bambook SDK，是0.9.5.2版，相比第一次發(fā)布的0.9.0.0版，我們有了非常多的改進與功能增強，值得費一些篇幅，來為大家介紹一下。

  這次的版本，主要的特點有以下幾個：

  1、 增加了5個函數(shù)返回值定義，完善出錯處理的各種情況

  2、 完善了頭文件的定義，比以前更加清晰了

  3、 允許訪問Bambook中的版權(quán)書籍信息與章節(jié)信息

  4、 文檔全面采用doxygen生成

  5、 通過各種方式，盡可能減少對于回調(diào)函數(shù)的使用

  整個API，從原本的16個函數(shù)，增加到11大類共62個函數(shù)。

  在書籍列表獲取的速度方面，較之以前有10倍以上的提升。

  二、 論壇互動

  由于各位熱心的開發(fā)者積極地為SDK提意見和建議，我們的SDK才能有這么大的進步，感謝大家。下面簡單摘錄一些論壇里互動的情況：

  foxriver：

  1. api接口里，應(yīng)該明確加上是__cdecl，還是__stdcall參數(shù)傳遞方式。

  答：這個已經(jīng)有了

  2. api接口里，應(yīng)該寫明，那些是輸入輸出參數(shù)，就像MSDN里的IN/OUT定義。

  答：這個已經(jīng)有了

  3. api接口里，解壓/壓縮沒有內(nèi)存序列化方法，老是要用生成臨時文件來處理，這點不方便。

  答：這個已經(jīng)有了一組完整的函數(shù)

  lifanxi：如何獲知新上傳的書籍的GUID?

  答：新增了BambookAddPrivBookEx函數(shù)，可以獲取GUID

  yaer：怎么不提供書架的管理函數(shù)呀

  答：目前已經(jīng)提供了一組完整的版權(quán)書籍信息獲取函數(shù)，還有更新書架、更新具體書籍以及刪除的功能。

  Fantasysoft：關(guān)于Win32版 Java SDK的問題

  答：這主要是由于回調(diào)函數(shù)造成了，我們新版的SDK，已經(jīng)提供了另一種等價的方式，可以繞開各種回調(diào)的問題。

  Idalin：64位的到底啥時候出來啊啊啊啊啊

  答：64位版本的問題，在Windows7 64位版下用C#，使用非回調(diào)方式是可以正常工作的，linux下的64位，尚未完成。

  哥白不：給SDK加一個截圖函數(shù)吧

  答：這個我們計劃在下一版本的固件支持。

  qiaojie：這個C++的SDK API設(shè)計的也太不專業(yè)了

  答：字符集的問題，已經(jīng)新增了BambookSetCharacterEncoding來支持。

  書籍大小需要固件支持，目前的計劃是在BambookBookInfo結(jié)構(gòu)中新增一個字段描述書籍大小，顯示自有書的信息時，這個值大于0，版權(quán)書信息時，這個值等于0。

  獲取書籍列表的效率已經(jīng)10倍提升。

  Doxygen的支持已經(jīng)實現(xiàn)。

  dafu2003：請求開發(fā)人員提供VB調(diào)用定義模塊

  答：正在開發(fā)一個BambookCore的COM封裝BambookCore.ocx，預(yù)計本周內(nèi)可以放出一個測試版，這樣VB和其它支持com的語言都不需要單獨再移植了。

  三、函數(shù)分類介紹

  1、 基礎(chǔ)函數(shù)

  新增BambookSetCharacterEncoding，用于設(shè)定BambookCore的 API 接收和返回的字符串使用的字符集，默認(rèn)為GBK。

  2、 設(shè)備相關(guān)函數(shù)

  新增BambookGetBookShelfChangeCount，用于返回Bambook書籍列表變更計數(shù)器，當(dāng)用戶通過云梯、其它應(yīng)用程序或直接在設(shè)備上手工加書、刪書，以及設(shè)備從服務(wù)器上同步下新書時，變更計數(shù)器會自動加 1，應(yīng)用可以根據(jù)計數(shù)器的值來決定是否需要更新書架。使用BambookReplacePrivBook API可能不會影響變更計數(shù)。

  3、 書籍信息相關(guān)函數(shù)

  新增BambookFindFirstBook、BambookFindNextBook、BambookFindBookClose、BambookGetBookInfoById、BambookGetBookChapterCount、BambookGetBookChapterInfo。用于獲取書架上的各種書籍信息，不再像以前的版本，只能獲取自有書信息。更可以獲取每一本的章節(jié)信息，做更加細(xì)致的操作。

  4、 書簽相關(guān)函數(shù)

  新增BambookGetBookmark、BambookSetBookmark、BambookGetLastReadBook、BambookGetCurrentReadBook。用于獲取及設(shè)置用戶的書簽信息，獲得最后閱讀的書籍信息以及當(dāng)前正在閱讀的書籍信息。

  5、 書籍傳輸相關(guān)函數(shù)

  新增BambookAddPrivBookEx，以幫助開發(fā)者，在添加自有書之后，獲知新增書籍的GUID號。

  新增BambookGetSendPrivBookStatus、BambookGetFetchPrivBookStatus，以避免使用回調(diào)函數(shù)，在傳輸書籍時，將回調(diào)函數(shù)設(shè)置為NULL，然后通過以上兩個函數(shù)，來獲取傳輸?shù)臓顟B(tài)。

  新增BambookFetchPrivBookCover，以獲取自有書的封面文件。

  6、 版權(quán)書處理相關(guān)函數(shù)

  新增BambookUpdateBook、BambookUpdateBookShelf、BambookDeleteBook，用于更新一本或書架上的全部版權(quán)書，或者刪除一本版權(quán)書籍。

  7、 書籍分類相關(guān)函數(shù)

  新增BambookCatalogCreate、BambookCatalogFree、BambookCatalogLoad、BambookCatalogSave、BambookCatalogGetCount、BambookCatalogGetItem、BambookCatalogDeleteItem、BambookCatalogRenameItem、BambookCatalogInsertItem、BambookCatalogAppendItem、BambookCatalogMoveItem、BambookCatalogGetBookCount、BambookCatalogGetBook、BambookCatalogRemoveBook、BambookCatalogInsertBook、BambookCatalogAppendBook、BambookCatalogMoveBook共17個函數(shù)，用于書籍分類的管理。在這方面，我們期待有非常方便用戶的作品出現(xiàn)。

  8、 其他功能函數(shù)

  新增BambookTTSPlay、BambookTTSStop，使得PC端可以調(diào)用Bambook的TTS功能，讓Bambook為你說話。

  9、 SNB文件操作函數(shù)

  新增BambookSnbOpen、BambookSnbClose、BambookSnbGetFileInfo、BambookSnbGetFirstFileInfo、BambookSnbGetNextFileInfo、BambookSnbUnpackToMemory、BambookSnbUnpackToFile共7個函數(shù)，用于處理SNB文件，其中BambookSnbUnpackToMemory函數(shù)，可以方便開發(fā)者，也實現(xiàn)了foxriver當(dāng)初提出的需求。

  四、總結(jié)

  這個SDK，還處在逐步完善的過程中，期待各位朋友，能夠繼續(xù)提出給力的意見和建議，我們也會繼續(xù)努力的滿足你們的需求。