android 中文 api （72） —— BluetoothSocket

正文

　　一、結構

 

public static class Gallery.LayoutParams extends ViewGroup.LayoutParams

        

java.lang.Object

android.view. ViewGroup.LayoutParams

android.widget.Gallery.LayoutParams

 

 

　　二、概述

 

         已連接或連接到藍牙套接字(socket)。

         藍牙端口監聽接口和TCP端口類似：Socket和ServerSocket類。在服務器端，使用BluetoothServerSocket類來創建一個 監聽服務端口。當一個連接被BluetoothServerSocket所接受，它會返回一個新的BluetoothSocket來管理該連接。在客戶 端，使用一個單獨的BluetoothSocket類去初始化一個外接連接和管理該連接。

　最通常使用的藍牙端口是RFCOMM，它是被Android API支持的類型。RFCOMM是一個面向連接，通過藍牙模塊進行的數據流傳輸方式，它也被稱為串行端口規范（Serial Port Profile，SPP）。

　為了創建一個BluetoothSocket去連接到一個已知設備，使用方法 BluetoothDevice.createRfcommSocketToServiceRecord()。然後調用connect()方法去嘗試一個 面向遠程設備的連接。這個調用將被阻塞指導一個連接已經建立或者該鏈接失效。

　為了創建一個BluetoothSocket作為服務端（或者“主機”），查看BluetoothServerSocket文檔。

　每當該端口連接成功，無論它初始化為客戶端，或者被接受作為服務器端，通過getInputStream()和getOutputStream()來打開IO流，從而獲得各自的InputStream和OutputStream對象

　BluetoothSocket類線程安全。特別的，close()方法總會馬上放棄外界操作並關閉服務器端口。

　注意：需要BLUETOOTH權限。

　參見

         BluetoothServerSocket

　    InputStream

 　   OutputStream

 

 

　　三、公共方法

 

    public void close ()

馬上關閉該端口並且釋放所有相關的資源。

在其它線程的該端口中引起阻塞，從而使系統馬上拋出一個IO異常。

異常

IOException

 

    public void connect ()

嘗試連接到遠程設備。

該方法將阻塞，指導一個連接建立或者失效。如果該方法沒有返回異常值，則該端口現在已經建立。

當設備查找正在進行的時候，創建對遠程藍牙設備的新連接不可被嘗試。在藍牙適配器上，設備查找是一個重量級過程，並且肯定會降低一個設備的連接。使用 cancelDiscovery()方法去取消一個外界的查詢。查詢並不由活動所管理，而作為一個系統服務來運行，所以即使它不能直接請求一個查詢，應用 程序也總會調用cancelDiscovery()方法。

close()方法可以用來放棄從另一線程而來的調用。

異常

IOException     一個錯誤，例如連接失敗。

 

    public InputStream getInputStream ()

通過連接的端口獲得輸入數據流

即使該端口未連接，該輸入數據流也會返回。不過在該數據流上的操作將拋出異常，直到相關的連接已經建立。

返回值

輸入流

異常

IOException

 

    public OutputStream getOutputStream ()

通過連接的端口獲得輸出數據流

即使該端口未連接，該輸出數據流也會返回。不過在該數據流上的操作將拋出異常，直到相關的連接已經建立。

返回值

輸出流

異常

IOException

 

    public BluetoothDevice getRemoteDevice ()

獲得該端口正在連接或者已經連接的遠程設備。

返回值

　　　　　　遠程設備