chrome.bluetoothSocket

Açıklama

RFCOMM ve L2CAP bağlantılarını kullanarak Bluetooth cihazlarına veri göndermek ve almak için chrome.bluetoothSocket API'yi kullanın.

Manifest

Bu API'yi kullanmak için aşağıdaki anahtarlar manifest dosyasında beyan edilmelidir.

"bluetooth"

Türler

AcceptError

Enum

"system_error"
Sistem hatası oluştu ve bağlantı kurtarılamayabilir.

"not_listening"
Soket dinlememektedir.

AcceptErrorInfo

Özellikler

  • Sorunun ne olduğunu belirten 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ı (yani yeni kurulan bağlantının yuva tanımlayıcısı). Bu soket tanımlayıcısı yalnızca chrome.bluetoothSocket ad alanındaki işlevlerle kullanılmalıdır. Müşteri soketinin başlangıçta duraklatıldığını ve veri almaya başlamak için uygulama tarafından açıkça duraklatılmaması gerektiğini unutmayın.

  • socketId

    sayı

    Sunucu yuvası tanımlayıcısı.

CreateInfo

Özellikler

  • socketId

    sayı

    Yeni oluşturulan soketin kimliği. Bu API'den oluşturulan soket kimliklerinin, [sockets.tcp](../sockets_tcp/) API gibi diğer API'lerden oluşturulan soket kimlikleriyle uyumlu olmadığını unutmayın.

ListenOptions

Özellikler

  • iş listesi

    number isteğe bağlı

    Soketin dinleme sırasının uzunluğu. Varsayılan değer, işletim sisteminin ana alt sistemine bağlıdır.

  • kanal

    number isteğe bağlı

    listenUsingRfcomm tarafından kullanılan RFCOMM kanalı. Belirtilen kanal daha önce kullanılmıyor olmalıdır. Aksi takdirde yöntem çağrısı başarısız olur. Belirtilmediği takdirde kullanılmayan bir kanal otomatik olarak ayrılır.

  • psm

    number isteğe bağlı

    listenUsingL2cap tarafından kullanılan L2CAP PSM. Belirtilen PSM daha önce kullanılmıyorsa veya yöntem çağrısı başarısız olursa. Belirtilmediği takdirde, kullanılmayan bir PSM otomatik olarak atanır.

ReceiveError

Enum

"disconnected"
Bağlantının bağlantısı kesildi.

"system_error"
Sistem hatası oluştu ve bağlantı kurtarılamayabilir.

"not_connected"
Soket bağlanmadı.

ReceiveErrorInfo

Özellikler

  • Sorunun ne olduğunu belirten bir hata kodu.

  • errorMessage

    dize

    Hata mesajı.

  • socketId

    sayı

    Soket tanımlayıcısı.

ReceiveInfo

Özellikler

  • veri

    ArrayBuffer

    Alınan veriler (maksimum boyut bufferSize).

  • socketId

    sayı

    Soket tanımlayıcısı.

SocketInfo

Özellikler

  • adres

    dize isteğe bağlı

    Temel soket bağlıysa bağlı olduğu cihazın Bluetooth adresini içerir.

  • bufferSize

    number isteğe bağlı

    Veri almak için kullanılan arabelleğin boyutu. Açıkça bir arabellek boyutu belirtilmediyse değer sağlanmaz.

  • bağlandı

    boolean

    Soketin uzak bir eşe bağlı olup olmadığını belirten işaret.

  • ad

    dize isteğe bağlı

    Soketle ilişkili uygulama tanımlı dize.

  • duraklatıldı

    boolean

    Bağlı bir soketin, eşleğinin daha fazla veri göndermesini engelleyip engellemediğini veya dinleyici soketindeki bağlantı isteklerinin onAccept etkinliği aracılığıyla gönderilip gönderilmediğini ya da dinleme ipi iş listesinde sıraya alınıp alınmadığını belirten işaret. Şu sayfaya göz atın: setPaused. Varsayılan değer "false" değeridir.

  • kalıcı

    boolean

    Uygulamanın etkinlik sayfası yüklenmediğinde soketin açık kalıp kalmayacağını belirten işaret (SocketProperties.persistent bölümüne bakın). Varsayılan değer "false".

  • socketId

    sayı

    Soket tanımlayıcısı.

  • uuid

    dize isteğe bağlı

    Temel soket bağlıysa bağlı olduğu hizmetin UUID'si, aksi takdirde temel soket dinliyorsa dinlediği hizmetin UUID'si hakkında bilgi içerir.

SocketProperties

Özellikler

  • bufferSize

    number isteğe bağlı

    Veri almak için kullanılan arabelleğin boyutu. Varsayılan değer 4096'dır.

  • ad

    dize isteğe bağlı

    Soketle ilişkili, uygulama tarafından tanımlanan bir dize.

  • kalıcı

    boole isteğe bağlı

    Uygulamanın etkinlik sayfası yüklenmediğinde soketin açık bırakılıp bırakılmadığını belirten işaret (Uygulama Yaşam Döngüsünü Yönetme bölümüne bakın). Varsayılan değer false.'tür. Uygulama yüklendiğinde, daha önce persistent=true ile açılan tüm soketler getSockets ile getirilebilir.

Yöntemler

close()

Promise 
chrome.bluetoothSocket.close(
  socketId: number,
  callback?: function,
)

Soketin bağlantısını keser ve soketi yok eder. Oluşturulan her soket kullanımdan sonra kapatılmalıdır. İşlev çağrıldıktan sonra soket kimliği artık geçerli değildir. Ancak, soketin yalnızca geri çağırma işlevi çağrıldığında kapatılacağı garanti edilir.

Parametreler

  • socketId

    sayı

    Soket tanımlayıcısı.

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Chrome 91 ve sonraki sürümler

    Sözler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

connect()

Promise 
chrome.bluetoothSocket.connect(
  socketId: number,
  address: string,
  uuid: string,
  callback?: function,
)

Prizi uzak bir Bluetooth cihazına bağlar. connect işlemi başarıyla tamamlandığında, eş taraftan veri alındığında onReceive etkinlikleri oluşturulur. Çalışma zamanı paket alırken bir ağ hatası oluşursa bir onReceiveError etkinliği tetiklenir. Bu noktada, setPaused(false) yöntemi çağrılana kadar bu soket için başka onReceive etkinliği tetiklenmez.

Parametreler

  • socketId

    sayı

    Soket tanımlayıcısı.

  • adres

    dize

    Bluetooth cihazının adresi.

  • uuid

    dize

    Bağlanacak hizmetin UUID'si.

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Chrome 91 ve sonraki sürümler

    Sözler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

create()

Promise 
chrome.bluetoothSocket.create(
  properties?: SocketProperties,
  callback?: function,
)

Bluetooth yuvası oluşturur.

Parametreler

  • mülkler

    SocketProperties isteğe bağlı

    Soket özellikleri (isteğe bağlı).

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (createInfo: CreateInfo) => void

    • createInfo

      CreateInfo

      Soket oluşturma işleminin sonucu.

İadeler

  • Promise<CreateInfo>

    Chrome 91 ve sonraki sürümler

    Sözler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

disconnect()

Promise 
chrome.bluetoothSocket.disconnect(
  socketId: number,
  callback?: function,
)

Prizin bağlantısını keser. Soket tanımlayıcısı geçerliliğini korur.

Parametreler

  • socketId

    sayı

    Soket tanımlayıcısı.

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Chrome 91 ve sonraki sürümler

    Sözler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

getInfo()

Promise 
chrome.bluetoothSocket.getInfo(
  socketId: number,
  callback?: function,
)

Belirtilen soketin durumunu alır.

Parametreler

  • socketId

    sayı

    Soket tanımlayıcısı.

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (socketInfo: SocketInfo) => void

    • socketInfo

      SocketInfo

      Soket bilgilerini içeren nesne.

İadeler

  • Promise<SocketInfo>

    Chrome 91 ve sonraki sürümler

    Sözler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

getSockets()

Promise 
chrome.bluetoothSocket.getSockets(
  callback?: function,
)

Uygulamaya ait şu anda açık olan soketlerin listesini alır.

Parametreler

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (sockets: SocketInfo[]) => void

İadeler

  • Promise<SocketInfo[]>

    Chrome 91 ve sonraki sürümler

    Sözler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

listenUsingL2cap()

Promise 
chrome.bluetoothSocket.listenUsingL2cap(
  socketId: number,
  uuid: string,
  options?: ListenOptions,
  callback?: function,
)

L2CAP protokolünü kullanarak bağlantıları dinler.

Parametreler

  • socketId

    sayı

    Soket tanımlayıcısı.

  • uuid

    dize

    Dinlenecek hizmet UUID'si.

  • seçenekler

    ListenOptions isteğe bağlı

    Hizmet için isteğe bağlı ek seçenekler.

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Chrome 91 ve sonraki sürümler

    Sözler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

listenUsingRfcomm()

Promise 
chrome.bluetoothSocket.listenUsingRfcomm(
  socketId: number,
  uuid: string,
  options?: ListenOptions,
  callback?: function,
)

RFCOMM protokolünü kullanarak bağlantıları dinler.

Parametreler

  • socketId

    sayı

    Soket tanımlayıcısı.

  • uuid

    dize

    Dinlenecek hizmet UUID'si.

  • seçenekler

    ListenOptions isteğe bağlı

    Hizmet için isteğe bağlı ek seçenekler.

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Chrome 91 ve sonraki sürümler

    Sözler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

send()

Promise 
chrome.bluetoothSocket.send(
  socketId: number,
  data: ArrayBuffer,
  callback?: function,
)

Belirtilen Bluetooth soketine veri gönderir.

Parametreler

  • socketId

    sayı

    Soket tanımlayıcısı.

  • veri

    ArrayBuffer

    Gönderilecek veriler.

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (bytesSent: number) => void

    • bytesSent

      sayı

      Gönderilen bayt sayısı.

İadeler

  • Promise<number>

    Chrome 91 ve sonraki sürümler

    Sözler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

setPaused()

Promise 
chrome.bluetoothSocket.setPaused(
  socketId: number,
  paused: boolean,
  callback?: function,
)

Bağlı bir soketin eşinden mesaj almasını veya dinleyici bir soketin yeni bağlantılar kabul etmesini etkinleştirir ya da devre dışı bırakır. Varsayılan değer "false" değeridir. Bağlı bir soketi duraklatma işlemi, genellikle bir uygulama tarafından eş taraf tarafından gönderilen verileri kısıtlamak için kullanılır. Bağlı bir soket duraklatıldığında onReceiveetkinliği tetiklenmez. Bir soket bağlandığında ve duraklatma kaldırıldığında, mesaj alındığında onReceive etkinlikleri tekrar oluşturulur. Dinleme soketi duraklatıldığında, bekleme listesi dolana kadar yeni bağlantılar kabul edilir ve ardından ek bağlantı istekleri reddedilir. onAccept etkinlikleri yalnızca soket duraklatıldığında kaldırılır.

Parametreler

  • socketId

    sayı

  • duraklatıldı

    boolean

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Chrome 91 ve sonraki sürümler

    Sözler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

update()

Promise 
chrome.bluetoothSocket.update(
  socketId: number,
  properties: SocketProperties,
  callback?: function,
)

Soket özelliklerini günceller.

Parametreler

  • socketId

    sayı

    Soket tanımlayıcısı.

  • mülkler

    SocketProperties

    Güncellenecek tesisler.

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Chrome 91 ve sonraki sürümler

    Sözler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

Etkinlikler

onAccept

chrome.bluetoothSocket.onAccept.addListener(
  callback: function,
)

Belirli bir soket için bağlantı kurulduğunda oluşturulan etkinlik.

Parametreler

  • geri çağırma

    işlev

    callback parametresi şu şekilde görünür: 

    (info: AcceptInfo) => void

onAcceptError

chrome.bluetoothSocket.onAcceptError.addListener(
  callback: function,
)

Çalışma zamanı belirli bir sokette yeni bağlantılar beklerken bir ağ hatası oluştuğunda etkinlik tetiklenir. Bu etkinlik tetiklendikten sonra soket paused olarak ayarlanır ve bu soket için başka onAccept etkinliği tetiklenmez.

Parametreler

onReceive

chrome.bluetoothSocket.onReceive.addListener(
  callback: function,
)

Belirli bir soket için veri alındığında oluşturulan etkinlik.

Parametreler

  • geri çağırma

    işlev

    callback parametresi şu şekilde görünür: 

    (info: ReceiveInfo) => void

onReceiveError

chrome.bluetoothSocket.onReceiveError.addListener(
  callback: function,
)

Çalışma zamanı sokette veri beklerken bir ağ hatası oluştuğunda etkinlik oluşturulur. Bu etkinlik tetiklendikten sonra soket paused olarak ayarlanır ve bu soket için başka onReceive etkinliği tetiklenmez.

Parametreler