《盛大Bambook SDK 0.9.5.2版》介紹

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

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

  這次的版本，主要的特點(diǎn)有以下幾個(gè)：

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

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

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

  4、 文檔全面采用doxygen生成

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

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

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

  二、 論壇互動(dòng)

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

  foxriver：

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

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

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

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

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

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

  lifanxi：如何獲知新上傳的書(shū)籍的GUID?

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

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

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

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

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

  Idalin：64位的到底啥時(shí)候出來(lái)啊啊啊啊啊

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

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

  答：這個(gè)我們計(jì)劃在下一版本的固件支持。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  四、總結(jié)

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