Açıklama
RFCOMM ve L2CAP bağlantılarını kullanarak Bluetooth cihazlarına veri gönderip almak için chrome.bluetoothSocket
API'sini kullanın.
Manifest
Türler
AcceptError
Enum
"system_error"
Bir sistem hatası oluştu ve bağlantı kurtarılamaz.
"not_listening"
Soket dinlemiyor.
AcceptErrorInfo
Özellikler
-
hata
Sorunun ne olduğunu gösteren bir hata kodu.
-
errorMessage
dize
Hata mesajı.
-
socketId
sayı
Sunucu yuvası tanımlayıcısı.
AcceptInfo
Özellikler
-
clientSocketId
sayı
İstemci yuva tanımlayıcısı, ör. yeni kurulan bağlantının yuva tanımlayıcısı. Bu yuva tanımlayıcısı yalnızca
chrome.bluetoothSocket
ad alanındaki işlevlerle kullanılmalıdır. İstemci yuvasının başlangıçta duraklatıldığını ve veri almaya başlaması için uygulamanın duraklatmasının açıkça kaldırılması gerektiğini unutmayın. -
socketId
sayı
Sunucu yuvası tanımlayıcısı.
CreateInfo
Özellikler
-
socketId
sayı
Yeni oluşturulan yuvanın kimliği. Bu API'den oluşturulan yuva kimliklerinin
[
sockets.tcp](../sockets_tcp/)
API'si gibi diğer API'lerden oluşturulan yuva kimlikleriyle uyumlu olmadığını unutmayın.
ListenOptions
Özellikler
-
iş listesi
numara isteğe bağlı
Yuvanın dinleme sırasının uzunluğu. Varsayılan değer, işletim sisteminin ana makine alt sistemine bağlıdır.
-
kanal
numara isteğe bağlı
listenUsingRfcomm
tarafından kullanılan RFCOMM Kanalı. Belirtilirse bu kanal daha önce kullanımda olmamalıdır. Aksi takdirde, yöntem çağrısı başarısız olur. Belirtilmediğinde kullanılmayan bir kanal otomatik olarak ayrılır. -
/sn
numara isteğe bağlı
listenUsingL2cap
tarafından kullanılan L2CAP PSM. Belirtilirse bu PSM daha önce kullanımda olmamalı veya yöntem çağrısının başarısız olması gerekir. Belirtilmediğinde kullanılmayan bir PSM otomatik olarak ayrılır.
ReceiveError
Enum
"disconnected"
Bağlantı kesildi.
"system_error"
Bir sistem hatası oluştu ve bağlantı kurtarılamaz.
"not_connected"
Yuva bağlanmadı.
ReceiveErrorInfo
Özellikler
-
hata
Sorunun ne olduğunu gösteren bir hata kodu.
-
errorMessage
dize
Hata mesajı.
-
socketId
sayı
Yuva tanımlayıcısı.
ReceiveInfo
Özellikler
-
veri
ArrayBuffer
Maksimum
bufferSize
boyutunda alınan veriler. -
socketId
sayı
Yuva tanımlayıcısı.
SocketInfo
Özellikler
-
adres
string isteğe bağlı
Alttaki yuva bağlıysa bağlı olduğu cihazın Bluetooth adresini içerir.
-
bufferSize
numara isteğe bağlı
Verileri almak için kullanılan arabelleğin boyutu. Açıkça herhangi bir tampon boyutu belirtilmediyse değer sağlanmaz.
-
bağlandı
boolean
Yuvanın uzak bir eşe bağlı olup olmadığını gösteren işaret.
-
ad
string isteğe bağlı
Yuvayla ilişkilendirilen uygulama tanımlı dize.
-
duraklatıldı
boolean
Bağlı bir yuvanın eşinin daha fazla veri göndermesini engellediğini veya bir dinleme soketindeki bağlantı isteklerinin
onAccept
etkinliği üzerinden gönderilip gönderilmediğini ya da dinleme sırası yığınında sıraya alınıp alınmadığını gösteren işaret. Şu sayfaya göz atın:setPaused
. Varsayılan değer "false" değeridir. -
inatçı
boolean
Uygulamanın etkinlik sayfası kaldırıldığında soketin açık kalıp kalmadığını gösteren işaret (bkz.
SocketProperties.persistent
). Varsayılan değer "false" (yanlış) değeridir. -
socketId
sayı
Yuva tanımlayıcısı.
-
uuid
string isteğe bağlı
Temel yuva bağlıysa bağlı olduğu hizmet UUID'si ile ilgili bilgileri içerir, aksi takdirde temel yuva dinliyorsa dinlediği hizmet UUID'si hakkında bilgiler içerir.
SocketProperties
Özellikler
-
bufferSize
numara isteğe bağlı
Verileri almak için kullanılan arabelleğin boyutu. Varsayılan değer 4096'dır.
-
ad
string isteğe bağlı
Yuvayla ilişkilendirilmiş, uygulama tanımlı bir dize.
-
inatçı
boole isteğe bağlı
Uygulamanın etkinlik sayfası kaldırıldığında soketin açık kalıp kalmadığını gösteren işaret (Uygulama Yaşam Döngüsünü Yönetme bölümüne bakın). Varsayılan değer
false.
şeklindedir. Uygulama yüklendiğinde, daha önce kalıcı=doğru ile açılmış olan tüm yuvalargetSockets
ile getirilebilir.
Yöntemler
close()
chrome.bluetoothSocket.close(
socketId: number,
callback?: function,
)
Yuvanın bağlantısını keser ve yuvayı yok eder. Oluşturulan her yuva kullanıldıktan sonra kapatılmalıdır. İşlev çağrıldığı anda yuva kimliği artık geçerli değildir. Ancak yalnızca geri çağırma çağrıldığında yuvanın kapatılması garanti edilir.
Parametreler
-
socketId
sayı
Yuva tanımlayıcısı.
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 91 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
connect()
chrome.bluetoothSocket.connect(
socketId: number,
address: string,
uuid: string,
callback?: function,
)
Yuvayı uzak bir Bluetooth cihazına bağlar. connect
işlemi başarıyla tamamlandığında, eşten veri alındığında onReceive
etkinlik yükseltilir. Çalışma zamanı paketleri alırken bir ağ hatası oluşursa bir onReceiveError
etkinliği oluşturulur. Bu noktada, setPaused(false)
yöntemi çağrılana kadar bu yuva için başka onReceive
etkinliği oluşturulmaz.
Parametreler
-
socketId
sayı
Yuva tanımlayıcısı.
-
adres
dize
Bluetooth cihazının adresi.
-
uuid
dize
Bağlanılacak hizmetin UUID'si.
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 91 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
create()
chrome.bluetoothSocket.create(
properties?: SocketProperties,
callback?: function,
)
Bluetooth yuvası oluşturur.
Parametreler
-
mülkler
SocketProperties isteğe bağlı
Yuva özellikleri (isteğe bağlı).
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(createInfo: CreateInfo) => void
-
createInfo
Yuva oluşturma işleminin sonucu.
-
İlerlemeler
-
Promise<CreateInfo>
Chrome 91 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
disconnect()
chrome.bluetoothSocket.disconnect(
socketId: number,
callback?: function,
)
Prizin bağlantısını keser. Yuva tanımlayıcısı geçerli olmaya devam eder.
Parametreler
-
socketId
sayı
Yuva tanımlayıcısı.
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 91 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
getInfo()
chrome.bluetoothSocket.getInfo(
socketId: number,
callback?: function,
)
Belirtilen yuvanın durumunu alır.
Parametreler
-
socketId
sayı
Yuva tanımlayıcısı.
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(socketInfo: SocketInfo) => void
-
socketInfo
Yuva bilgilerini içeren nesne.
-
İlerlemeler
-
Promise<SocketInfo>
Chrome 91 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
getSockets()
chrome.bluetoothSocket.getSockets(
callback?: function,
)
Uygulamanın sahip olduğu, açık durumdaki yuvaların listesini alır.
Parametreler
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(sockets: SocketInfo[]) => void
-
yuvalar
-
İlerlemeler
-
Promise<SocketInfo[]>
Chrome 91 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
listenUsingL2cap()
chrome.bluetoothSocket.listenUsingL2cap(
socketId: number,
uuid: string,
options?: ListenOptions,
callback?: function,
)
L2CAP protokolünü kullanarak bağlantıları dinleyin.
Parametreler
-
socketId
sayı
Yuva tanımlayıcısı.
-
uuid
dize
Dinlenecek UUID hizmeti.
-
seçenekler
ListenOptions isteğe bağlı
Hizmet için isteğe bağlı ek seçenekler.
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 91 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
listenUsingRfcomm()
chrome.bluetoothSocket.listenUsingRfcomm(
socketId: number,
uuid: string,
options?: ListenOptions,
callback?: function,
)
RFCOMM protokolünü kullanarak bağlantıları dinleyin.
Parametreler
-
socketId
sayı
Yuva tanımlayıcısı.
-
uuid
dize
Dinlenecek UUID hizmeti.
-
seçenekler
ListenOptions isteğe bağlı
Hizmet için isteğe bağlı ek seçenekler.
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 91 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
send()
chrome.bluetoothSocket.send(
socketId: number,
data: ArrayBuffer,
callback?: function,
)
Belirtilen Bluetooth soketinde veri gönderir.
Parametreler
-
socketId
sayı
Yuva tanımlayıcısı.
-
veri
ArrayBuffer
Gönderilecek veriler.
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(bytesSent: number) => void
-
bytesSent
sayı
Gönderilen bayt sayısı.
-
İlerlemeler
-
Vaat<sayı>
Chrome 91 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
setPaused()
chrome.bluetoothSocket.setPaused(
socketId: number,
paused: boolean,
callback?: function,
)
Bağlı bir yuvanın eşinden mesaj almasını etkinleştirir veya devre dışı bırakır ya da bir dinleme yuvasının yeni bağlantıları kabul etmesini sağlar. Varsayılan değer "false" değeridir. Bağlı bir yuvanın duraklatılması, genellikle bir uygulama tarafından, eşi tarafından gönderilen verileri daraltmak için kullanılır. Bağlı bir yuva duraklatıldığında onReceive
etkinliği yükseltilmez. Bir yuva bağlandığında ve duraklatması kaldırıldığında, mesaj alındığında onReceive
etkinlikleri tekrar yükselir. Bir dinleme yuvası duraklatıldığında, iş listesi dolana kadar yeni bağlantılar kabul edilir ve ardından ek bağlantı istekleri reddedilir. onAccept
etkinlikleri yalnızca yuvanın duraklatması kaldırıldığında yükseltilir.
Parametreler
-
socketId
sayı
-
duraklatıldı
boolean
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 91 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
update()
chrome.bluetoothSocket.update(
socketId: number,
properties: SocketProperties,
callback?: function,
)
Yuva özelliklerini günceller.
Parametreler
-
socketId
sayı
Yuva tanımlayıcısı.
-
mülkler
Güncellenecek özellikler.
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 91 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
Etkinlikler
onAccept
chrome.bluetoothSocket.onAccept.addListener(
callback: function,
)
Belirli bir yuva için bağlantı kurulduğunda gösterilen etkinlik.
Parametreler
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(info: AcceptInfo) => void
-
bilgi
-
onAcceptError
chrome.bluetoothSocket.onAcceptError.addListener(
callback: function,
)
Çalışma zamanı belirtilen yuvada yeni bağlantıları beklerken bir ağ hatası oluştuğunda etkinlik oluşuyordu. Bu etkinlik yükseltildiğinde, yuva paused
olarak ayarlanır ve bu yuva için başka onAccept
etkinliği yükseltilmez.
Parametreler
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(info: AcceptErrorInfo) => void
-
bilgi
-
onReceive
chrome.bluetoothSocket.onReceive.addListener(
callback: function,
)
Belirli bir yuva için veri alındığında ortaya çıkan etkinlik.
Parametreler
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(info: ReceiveInfo) => void
-
bilgi
-
onReceiveError
chrome.bluetoothSocket.onReceiveError.addListener(
callback: function,
)
Çalışma zamanı yuvada veri beklerken bir ağ hatası oluştuğunda ortaya çıkan etkinlik. Bu etkinlik yükseltildiğinde, yuva paused
olarak ayarlanır ve bu yuva için başka onReceive
etkinliği yükseltilmez.
Parametreler
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(info: ReceiveErrorInfo) => void
-
bilgi
-