由於最近一直忙專案，沒有時間來更新文件，今天抽空來寫一點，希望大家可以學習使用！

     這一章當然還是來分析FM模組的原始碼。FmReceiver.java

publicFmReceiver(String devicePath,FmRxEvCallbacksAdaptor callback) throwsInstantiationException {

      mControl = new FmRxControls();

      mRxEvents = new FmRxEventListner();

      //registerClient(callback);

      mCallback = callback;

   }
 

/**註冊一個回撥為調頻接收機事件通知。
* < p >
*這是一個同步命令用於註冊的事件通知調頻接收機的司機。自調頻驅動非同步執行一些任務,該功能允許客戶端非同步接收資訊。
* < p >
*在呼叫該函式時,客戶機必須通過一個回撥函式用來實現非同步事件。必須非空值引數的回撥。如果一個NULL值傳遞給這個函式,註冊將會失敗。
* < p >
*客戶端可以選擇哪些事件將從接收器傳送司機只需實現事件希望接收的功能。
* < p >
* @param回撥事件回撥處理事件的調頻接收機。

* @return真如果回撥註冊,假如果回撥註冊失敗了。
*初始化失敗。
* < p >

* @see #收購
*@see # unregisterClient

**/

public boolean registerClient(FmRxEvCallbacks callback){
      boolean status;
      status = super.registerClient(callback);
      /* Do Receiver Specific Stuff here.*/

      return status;
   }

 /**
   *   使調頻裝置在接收模式。
   *    <p>
   *    這是一個同步的方法用於初始化調頻接收機。如果已經初始化該函式將intialize接收者使用預設設定。只有在成功地呼叫這個函式的許多調頻裝置介面可以使用。
   *    <p>
   *    使接收者時,客戶機還必須提供的區域設定接收器將運作。這些設定(包括引數configSettings)通常用於設定調頻接收機操作在一個特定的地理區域。這些設定可以更改後啟用調頻驅動程式通過使用函式{ @link #配置}。
   *    <p>

*    這個命令只能出具一個調頻接收器的所有者。發出這個命令,客戶機必須首先成功叫{ @link #獲得}。
   *    <p>
   *    @param configSettings設定開啟收音機時應用
   *    @return真如果初始化成功了,假如果初始化失敗。
   *    <p>
   *@see #啟用
  *@see # registerClient
  *@see #禁用
   *
   */

public boolean enable (FmConfig configSettings)

/ * *
*重置調頻裝置。
* < p >
*這是一個同步命令用於重置調頻裝置的狀態不可恢復的錯誤。這個函式時將使用客戶端收到意想不到的廣播通知禁用。曾稱,大多數調頻裝置提供的功能將被禁用,直到客戶端還可以重新開啟裝置再次通過{ @link #可用}。
* < p >

*@return真如果復位成功了,假如果重置失敗了。
@see #啟用
@see #禁用
@see # registerClient
* /

publicboolean reset()

/ * *
*禁用調頻裝置。
* < p >
*這是一個同步命令用於禁用調頻裝置。時這個函式將使用客戶端不再需要使用調頻裝置。曾稱,大多數調頻裝置提供的功能將被禁用,直到客戶端還可以重新開啟裝置再次通過{ @link #可用}。
* < p >
* @return真如果禁用成功了,假如果禁用失敗了。
@see #啟用
@see # registerClient

* /

publicboolean disable()

/ * *
*獲取當前搜尋操作的狀態。
* < p >
時這個函式將使用searchStations()函式想知道是否尋求/掃描/自動選擇操作已經正在進行。
如果一個尋求命令時發出一個已經正在進行,我們取消正在尋求命令和開始新的搜尋操作。
* < p >

* @return調頻搜尋操作的當前狀態:
* SRCH_COMPLETE
* SRCH_INPROGRESS
* SRCH_ABORTED
* /

static int getSearchState()

/ * *
*設定搜尋操作的當前狀態。
* < p >

*這個函式是用於設定當前狀態的搜尋操作。如果一個尋求命令時發出一個已經正在進行,我們取消正在尋求命令,搜尋操作的狀態設定為SRCH_ABORTED和開始新的搜尋。
* < p >
* @return沒有
* /

static void setSearchState(int state)

/ * *
*啟動基本的尋求和掃描操作。
*
* < p >
*使用此命令來呼叫一個基本尋求/ FM無線電頻段的掃描

* < p >
* < ul >
*這個API用於:<李>呼叫基本尋求操作({ @link # FM_RX_SRCH_MODE_SEEK })<李>呼叫基本的掃描操作({ @link # FM_RX_SRCH_MODE_SCAN })
* < / ul >

* < p >
*這個函式執行的最基本的操作是一個{ @link # FM_RX_SRCH_MODE_SEEK }的命令。遞增或遞減的尋求過程處理頻率在預定義的通道的步驟(由通道間隔定義)和測量得到的訊號電平。一旦成功調站,發現為了達到或超過這個訊號電平,尋求操作將完成和FmRxEvSearchComplete事件將返回給客戶端。如果沒有發現匹配搜尋標準站,頻率將會回到最初調諧。* < p >

*由於尋求總是導致頻率調諧,每個尋求操作也將返回一個FmRxEvRadioTuneStatus事件到客戶機/應用程式層。
*
* < p >

就像{ @link # FM_RX_SRCH_MODE_SEEK },{ @link # FM_RX_SRCH_MODE_SCAN }命令可以比作許多背靠背尋求一段住在每個成功的追求。一旦釋出,掃描將增量或減量的頻率定義通道間隔直到找到站達到或超過搜尋閾值集。一旦發現本站,併成功地調整,FmRxEvRadioTuneStatus事件將返回給客戶端,車站仍將調整為特定的時間內由引數dwellPeriod表示。時間到期後,FmRxEvSearchInProgress事件將被髮送到客戶端和一個新的將開始尋找下一站符合搜尋閾值。後掃描整個樂隊,或取消後搜尋已經由客戶端發起,FmRxEvRadioTuneStatus事件將被髮送到客戶端。類似於尋求命令,每個掃描將導致至少一個站被調整,即使這是起始頻率。
* < p >
*每次司機啟動搜尋(尋求或掃描)客戶端將通過一個FmRxEvSearchInProgress事件通知。同樣,每次搜尋完成後,客戶端將通過一個FmRxEvRadioTuneStatus事件通知。
* < p >
*搜尋可以在任何時候被取消使用API cancelSearch()。一旦取消,每個搜尋將調到最後一站和生成FmRxEvSearchComplete和FmRxEvRadioTuneStatus事件。有效引數值“模式”:
* < ul >
   * <li>{@link #FM_RX_SRCH_MODE_SEEK}
   *  <li>{@link #FM_RX_SRCH_MODE_SCAN}
* < / ul >
* < p >
*有效引數值“dwellPeriod”:
* < ul >
   *    <li>{@link #FM_RX_DWELL_PERIOD_1S}
   *    <li>{@link #FM_RX_DWELL_PERIOD_2S}
   *    <li>{@link #FM_RX_DWELL_PERIOD_3S}
   *    <li>{@link #FM_RX_DWELL_PERIOD_4S}
   *    <li>{@link #FM_RX_DWELL_PERIOD_5S}
   *    <li>{@link #FM_RX_DWELL_PERIOD_6S}
   *    <li>{@link #FM_RX_DWELL_PERIOD_7S}
* < / ul >
* < p >
*有效引數值“方向”:
* < ul >
   *    <li>{@link #FM_RX_SEARCHDIR_DOWN}
   *    <li>{@link #FM_RX_SEARCHDIR_UP}
* < / ul >
* < p >
* @param模式調頻的搜尋模式。
@param dwellPeriod調頻掃描住時間。只有當使用
模式= { @link # FM_RX_SRCH_MODE_SCAN }
@param方向搜尋方向。

* < p >
* @return真如果搜尋啟動成功了,假如果搜尋啟動失敗。
@see # searchStations(int,int,int,int,int)
@see # searchStationList
* /

public boolean searchStations (int mode,int dwellPeriod,int direction)

public boolean searchStations (int mode,int dwellPeriod,int direction,int pty,int pi)

/ * *啟動站列表搜尋操作。
* < p >該方法將初啟搜尋,生成基於強和弱電臺的頻率列表中發現的調頻樂隊。
* < p >
* < ul >
*這個API是用於生成站列表包括:
* <li>強站(FM_RX_SRCHLIST_MODE_STRONGFM_RX_SRCHLIST_MODE_STRONGEST)
* <li>弱站(FM_RX_SRCHLIST_MODE_WEAKFM_RX_SRCHLIST_MODE_WEAKEST)
* < / ul >
* < p >

*掃描的頻率範圍取決於當前組樂隊。司機搜尋所有有效站在樂隊和完成後,返回一個頻道列表基於客戶的選擇。客戶端可以選擇搜尋中最強的電臺列表樂隊,樂隊最弱的電臺,或第N強弱。通過設定maximumStations引數,客戶端可以限制返回的頻率數在列表中。如果使用者指定引數maximumStations 0,搜尋將生成站的最大數量。

* < p >

*驅動每次啟動一個基於列表的搜尋,客戶端將通過一個FmRxEvSearchInProgress事件通知。類似地,每一次基於列表搜尋完成後,客戶端將通過一個FmRxEvSearchListComplete事件通知。
* < p >
*完成搜尋,最初調諧站將調諧和事件將生成如下:FmRxEvSearchListComplete——搜尋完成。FmRxEvRadioTuneStatus——re-tuned最初的頻率。

* < p >
*一旦發出搜尋命令,多個命令從客戶機可能不允許,直到搜尋完成或取消。
* < p >

搜尋可以在任何時候被取消使用API cancelSearch()。取消搜尋視為完成搜尋和事件將生成如下:FmRxEvSearchComplete——搜尋完成。FmRxEvRadioTuneStatus——re-tuned最初的頻率。
* < p >
* 有效引數值“模式”:
* < ul >
* <li> { @link #FM_RX_SRCHLIST_MODE_STRONG }
* <li> { @link #FM_RX_SRCHLIST_MODE_WEAK }
* <li> { @link #FM_RX_SRCHLIST_MODE_STRONGEST }
* <li> { @link #FM_RX_SRCHLIST_MODE_WEAKEST }
* <li> FM_RX_SRCHLIST_MODE_PTY(將來會實現嗎)
* < / ul >
* < p >
*有效引數值“方向”:

* < ul >   *    <li>{@link #FM_RX_SEARCHDIR_DOWN}
   *    <li>{@link #FM_RX_SEARCHDIR_UP}
* < / ul >
* < p >
* 有效引數值“maximumStations”:1 - 12

< p >
*@param模式調頻的搜尋模式。
@param方向搜尋方向。
@param maximumStations站的最大數量,可以從搜尋返回。這個引數被忽略和12站返回FM_RX_SRCHLIST_MODE_STRONGEST或FM_RX_SRCHLIST_MODE_WEAKEST如果搜尋模式
@param企業調頻RDS搜尋程式型別(目前不使用)
* < p >

* @return真如果搜尋啟動成功了,假如果搜尋啟動失敗。
@see # searchStations(int,int,int)
@see # searchStations(int,int,int,int,int)
* /

public boolean searchStationList (int mode,int direction,int maximumStations,int pty)

/ * *
*取消正在進行的搜尋操作 (掃描,尋找searchlist等等)。
* < p >

*這種方法應該用於取消之前啟動搜尋(例如基本尋求/掃描,RDS尋求/掃描、搜尋列表,等)。
* < p >
一旦完成,這個命令將生成一個FmRxEvSearchCancelledtr事件所有註冊的客戶。這個事件後,客戶端還可以接收搜尋事件正在進行相關搜尋正在完成。
*
* < p >
* @return真如果取消搜尋啟動成功,假如果取消搜尋啟動失敗。
@see # searchStations(int,int,int)
@see # searchStations(int,int,int)
@see # searchStationList
* /

關閉搜尋更改狀態

publicboolean cancelSearch ()

/ * *
*允許調頻接收機靜音和非靜音。
* < p >
*這是一個同步命令用於靜音或un-mute FM音訊。這個命令減弱來自FM音訊裝置。重要的是要注意,這隻會影響調頻音訊而不是其他音訊系統被使用。
* < p >
* @param沉默的模式設定應用模式
* < p >
@return真如果setMuteMode呼叫放置成功,假如果setMuteMode失敗了。
@see #啟用
@see # registerClient
* /

public boolean setMuteMode (int mode)

/ * *

*FM的單聲道/立體聲模式設定。
*
* < p >
*此命令允許使用者設定的單聲道/立體聲模式調頻裝置。使用此功能,使用者可以允許單聲道/立體聲混音或單聲道音訊的接待。
@param stereoEnable如此:支援立體聲,Mono錯誤的:力量
@return真如果setStereoMode呼叫放置成功,假如果setStereoMode失敗了。
* /

public boolean setStereoMode (booleanstereoEnable)

返回當前的RDS / RBDS計劃服務

publicFmRxRdsData  getPSInfo()

/ * *
*此函式返回一個頻率的列表。
*
* < p >
*該方法獲得的結果{ @link # searchStationList }。這種方法應該呼叫FmRxEvSearchListComplete時呼叫。
* < p >
*@return整數陣列,對應的頻率搜尋電臺
@see # searchStationList
* /

public int[] getStationList ()

/ * *
*此函式返回當前裝置的訊號強度

*
* < p >
*該方法返回當前的訊號強度調諧。
* < p >
* 目前@return RSSI的調諧
* /

public intgetRssi()