chrome.bluetoothSocket

বর্ণনা

RFCOMM এবং L2CAP সংযোগ ব্যবহার করে ব্লুটুথ ডিভাইসে ডেটা প্রেরণ ও গ্রহণ করতে chrome.bluetoothSocket API ব্যবহার করুন।

প্রাপ্যতা

শুধুমাত্র ChromeOS

প্রকাশ

এই এপিআইটি ব্যবহার করার জন্য ম্যানিফেস্টে নিম্নলিখিত কী-গুলো অবশ্যই ঘোষণা করতে হবে।

"bluetooth"

প্রকারভেদ

AcceptError

এনাম

"সিস্টেম_ত্রুটি"
সিস্টেমে একটি ত্রুটি ঘটেছে এবং সংযোগটি পুনরুদ্ধার করা সম্ভব নাও হতে পারে।

"শুনছে না"
সকেটটি শুনছে না।

AcceptErrorInfo

বৈশিষ্ট্য

  • ত্রুটি

    AcceptError

    একটি ত্রুটি কোড যা নির্দেশ করে কী ভুল হয়েছে।

  • ত্রুটির বার্তা

    স্ট্রিং

    ত্রুটির বার্তা।

  • সকেটআইডি

    সংখ্যা

    সার্ভার সকেট শনাক্তকারী।

AcceptInfo

বৈশিষ্ট্য

  • ক্লায়েন্ট সকেট আইডি

    সংখ্যা

    ক্লায়েন্ট সকেট আইডেন্টিফায়ার, অর্থাৎ নতুন স্থাপিত সংযোগের সকেট আইডেন্টিফায়ার। এই সকেট আইডেন্টিফায়ারটি শুধুমাত্র chrome.bluetoothSocket নেমস্পেসের ফাংশনগুলির সাথেই ব্যবহার করা উচিত। মনে রাখবেন, ক্লায়েন্ট সকেটটি প্রাথমিকভাবে পজ করা থাকে এবং ডেটা গ্রহণ শুরু করার জন্য অ্যাপ্লিকেশন দ্বারা এটিকে অবশ্যই স্পষ্টভাবে আন-পজ করতে হবে।

  • সকেটআইডি

    সংখ্যা

    সার্ভার সকেট শনাক্তকারী।

CreateInfo

বৈশিষ্ট্য

  • সকেটআইডি

    সংখ্যা

    নতুন তৈরি করা সকেটের আইডি। উল্লেখ্য যে, এই এপিআই থেকে তৈরি করা সকেট আইডিগুলো অন্যান্য এপিআই, যেমন [ sockets.tcp ](../sockets_tcp/) এপিআই থেকে তৈরি করা সকেট আইডিগুলোর সাথে সামঞ্জস্যপূর্ণ নয়।

ListenOptions

বৈশিষ্ট্য

  • ব্যাকলগ

    সংখ্যা ঐচ্ছিক

    সকেটের লিসেন কিউ-এর দৈর্ঘ্য। এর ডিফল্ট মান অপারেটিং সিস্টেমের হোস্ট সাবসিস্টেমের উপর নির্ভর করে।

  • চ্যানেল

    সংখ্যা ঐচ্ছিক

    listenUsingRfcomm দ্বারা ব্যবহৃত RFCOMM চ্যানেল। যদি এটি নির্দিষ্ট করা হয়, তবে এই চ্যানেলটি পূর্বে ব্যবহৃত হওয়া যাবে না, অন্যথায় মেথড কলটি ব্যর্থ হবে। যখন এটি নির্দিষ্ট করা হয় না, তখন একটি অব্যবহৃত চ্যানেল স্বয়ংক্রিয়ভাবে বরাদ্দ করা হবে।

  • পিএসএম

    সংখ্যা ঐচ্ছিক

    listenUsingL2cap দ্বারা ব্যবহৃত L2CAP PSM। যদি এটি নির্দিষ্ট করা হয়, তবে এই PSM-টি পূর্বে ব্যবহৃত হওয়া যাবে না, অন্যথায় মেথড কলটি ব্যর্থ হবে। যখন এটি নির্দিষ্ট করা হয় না, তখন একটি অব্যবহৃত PSM স্বয়ংক্রিয়ভাবে বরাদ্দ করা হবে।

ReceiveError

এনাম

"বিচ্ছিন্ন"
সংযোগ বিচ্ছিন্ন হয়ে গিয়েছিল।

"সিস্টেম_ত্রুটি"
সিস্টেমে একটি ত্রুটি ঘটেছে এবং সংযোগটি পুনরুদ্ধার করা সম্ভব নাও হতে পারে।

"সংযুক্ত নয়"
সকেটটি সংযুক্ত করা হয়নি।

ReceiveErrorInfo

বৈশিষ্ট্য

  • ত্রুটি

    ReceiveError

    একটি ত্রুটি কোড যা নির্দেশ করে কী ভুল হয়েছে।

  • ত্রুটির বার্তা

    স্ট্রিং

    ত্রুটির বার্তা।

  • সকেটআইডি

    সংখ্যা

    সকেট শনাক্তকারী।

ReceiveInfo

বৈশিষ্ট্য

  • ডেটা

    অ্যারেবাফার

    প্রাপ্ত ডেটার সর্বোচ্চ আকার হলো bufferSize ।

  • সকেটআইডি

    সংখ্যা

    সকেট শনাক্তকারী।

SocketInfo

বৈশিষ্ট্য

  • ঠিকানা

    স্ট্রিং ঐচ্ছিক

    যদি অন্তর্নিহিত সকেটটি সংযুক্ত থাকে, তবে এতে সংযুক্ত ডিভাইসটির ব্লুটুথ ঠিকানা থাকে।

  • বাফার সাইজ

    সংখ্যা ঐচ্ছিক

    ডেটা গ্রহণের জন্য ব্যবহৃত বাফারের আকার। যদি বাফারের আকার স্পষ্টভাবে উল্লেখ না করা থাকে, তবে মানটি প্রদান করা হয় না।

  • সংযুক্ত

    বুলিয়ান

    সকেটটি কোনো রিমোট পিয়ারের সাথে সংযুক্ত আছে কিনা তা নির্দেশকারী ফ্ল্যাগ।

  • নাম

    স্ট্রিং ঐচ্ছিক

    সকেটের সাথে যুক্ত অ্যাপ্লিকেশন-সংজ্ঞায়িত স্ট্রিং।

  • থামানো

    বুলিয়ান

    একটি ফ্ল্যাগ যা নির্দেশ করে যে, একটি সংযুক্ত সকেট তার অপর সকেটকে আরও ডেটা পাঠানো থেকে বাধা দেবে কিনা, অথবা একটি লিসেনিং সকেটের সংযোগের অনুরোধগুলি onAccept ইভেন্টের মাধ্যমে পাঠানো হবে নাকি লিসেন কিউ ব্যাকলগে জমা রাখা হবে। setPaused দেখুন। এর ডিফল্ট মান হলো "false"।

  • অবিরাম

    বুলিয়ান

    অ্যাপ্লিকেশনটির ইভেন্ট পেজ আনলোড হওয়ার পরেও সকেটটি খোলা থাকবে কি না, তা নির্দেশকারী ফ্ল্যাগ (দেখুন SocketProperties.persistent )। এর ডিফল্ট মান হলো 'false'।

  • সকেটআইডি

    সংখ্যা

    সকেট শনাক্তকারী।

  • uuid

    স্ট্রিং ঐচ্ছিক

    যদি অন্তর্নিহিত সকেটটি সংযুক্ত থাকে, তবে এটি যে সার্ভিস UUID-এর সাথে সংযুক্ত আছে সেটির তথ্য থাকে; অন্যথায় যদি অন্তর্নিহিত সকেটটি লিসেনিং অবস্থায় থাকে, তবে এটি যে সার্ভিস UUID-তে লিসেন করছে সেটির তথ্য থাকে।

SocketProperties

বৈশিষ্ট্য

  • বাফার সাইজ

    সংখ্যা ঐচ্ছিক

    ডেটা গ্রহণের জন্য ব্যবহৃত বাফারের আকার। এর ডিফল্ট মান হলো ৪০৯৬।

  • নাম

    স্ট্রিং ঐচ্ছিক

    সকেটের সাথে যুক্ত একটি অ্যাপ্লিকেশন-সংজ্ঞায়িত স্ট্রিং।

  • অবিরাম

    বুলিয়ান ঐচ্ছিক

    অ্যাপ্লিকেশনটির ইভেন্ট পেজ আনলোড হওয়ার সময় সকেটটি খোলা থাকবে কিনা তা নির্দেশকারী ফ্ল্যাগ (দেখুন অ্যাপ লাইফসাইকেল পরিচালনা )। এর ডিফল্ট মান হলো false. অ্যাপ্লিকেশনটি লোড হওয়ার সময়, persistent=true দিয়ে পূর্বে খোলা যেকোনো সকেট getSockets ব্যবহার করে অ্যাক্সেস করা যায়।

পদ্ধতি

close()

প্রতিশ্রুতি
chrome.bluetoothSocket.close(
  socketId: number,
  callback?: function,
): Promise<void>

সকেটটি বিচ্ছিন্ন করে এবং ধ্বংস করে দেয়। তৈরি করা প্রতিটি সকেট ব্যবহারের পর বন্ধ করে দেওয়া উচিত। ফাংশনটি কল করার সাথে সাথেই সকেট আইডিটি আর বৈধ থাকে না। তবে, শুধুমাত্র কলব্যাকটি আহ্বান করা হলেই সকেটটি বন্ধ হবে, এই নিশ্চয়তা দেওয়া হয়।

প্যারামিটার

  • সকেটআইডি

    সংখ্যা

    সকেট শনাক্তকারী।

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    callback প্যারামিটারটি দেখতে এইরকম: 

    () => void

ফেরত

  • প্রতিশ্রুতি<শূন্য>

    ক্রোম ৯১+

    প্রমিস শুধুমাত্র ম্যানিফেস্ট ভি৩ এবং এর পরবর্তী সংস্করণগুলোতে সমর্থিত, অন্যান্য প্ল্যাটফর্মে কলব্যাক ব্যবহার করতে হবে।

connect()

প্রতিশ্রুতি
chrome.bluetoothSocket.connect(
  socketId: number,
  address: string,
  uuid: string,
  callback?: function,
): Promise<void>

সকেটটিকে একটি দূরবর্তী ব্লুটুথ ডিভাইসের সাথে সংযুক্ত করে। connect প্রক্রিয়াটি সফলভাবে সম্পন্ন হলে, অপর প্রান্ত থেকে ডেটা গ্রহণ করার সময় onReceive ইভেন্টগুলো সক্রিয় হয়। রানটাইমে প্যাকেট গ্রহণ করার সময় যদি কোনো নেটওয়ার্ক ত্রুটি ঘটে, তাহলে একটি onReceiveError ইভেন্ট সক্রিয় হয়, এবং এরপর setPaused(false) মেথডটি কল না করা পর্যন্ত এই সকেটের জন্য আর কোনো onReceive ইভেন্ট সক্রিয় হবে না।

প্যারামিটার

  • সকেটআইডি

    সংখ্যা

    সকেট শনাক্তকারী।

  • ঠিকানা

    স্ট্রিং

    ব্লুটুথ ডিভাইসটির ঠিকানা।

  • uuid

    স্ট্রিং

    যে পরিষেবাটির সাথে সংযোগ করতে হবে তার UUID।

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    callback প্যারামিটারটি দেখতে এইরকম: 

    () => void

ফেরত

  • প্রতিশ্রুতি<শূন্য>

    ক্রোম ৯১+

    প্রমিস শুধুমাত্র ম্যানিফেস্ট ভি৩ এবং এর পরবর্তী সংস্করণগুলোতে সমর্থিত, অন্যান্য প্ল্যাটফর্মে কলব্যাক ব্যবহার করতে হবে।

create()

প্রতিশ্রুতি
chrome.bluetoothSocket.create(
  properties?: SocketProperties,
  callback?: function,
): Promise<CreateInfo>

একটি ব্লুটুথ সকেট তৈরি করে।

প্যারামিটার

  • বৈশিষ্ট্য

    সকেটপ্রপার্টি ঐচ্ছিক

    সকেটের বৈশিষ্ট্যসমূহ (ঐচ্ছিক)।

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    callback প্যারামিটারটি দেখতে এইরকম: 

    (createInfo: CreateInfo) => void

    • তথ্য তৈরি করুন

      CreateInfo

      সকেট তৈরির ফলাফল।

ফেরত

  • প্রতিশ্রুতি< তথ্য তৈরি করুন >

    ক্রোম ৯১+

    প্রমিস শুধুমাত্র ম্যানিফেস্ট ভি৩ এবং এর পরবর্তী সংস্করণগুলোতে সমর্থিত, অন্যান্য প্ল্যাটফর্মে কলব্যাক ব্যবহার করতে হবে।

disconnect()

প্রতিশ্রুতি
chrome.bluetoothSocket.disconnect(
  socketId: number,
  callback?: function,
): Promise<void>

সকেট সংযোগ বিচ্ছিন্ন করে। সকেট শনাক্তকারীটি বৈধ থাকে।

প্যারামিটার

  • সকেটআইডি

    সংখ্যা

    সকেট শনাক্তকারী।

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    callback প্যারামিটারটি দেখতে এইরকম: 

    () => void

ফেরত

  • প্রতিশ্রুতি<শূন্য>

    ক্রোম ৯১+

    প্রমিস শুধুমাত্র ম্যানিফেস্ট ভি৩ এবং এর পরবর্তী সংস্করণগুলোতে সমর্থিত, অন্যান্য প্ল্যাটফর্মে কলব্যাক ব্যবহার করতে হবে।

getInfo()

প্রতিশ্রুতি
chrome.bluetoothSocket.getInfo(
  socketId: number,
  callback?: function,
): Promise<SocketInfo>

প্রদত্ত সকেটটির অবস্থা পুনরুদ্ধার করে।

প্যারামিটার

  • সকেটআইডি

    সংখ্যা

    সকেট শনাক্তকারী।

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    callback প্যারামিটারটি দেখতে এইরকম: 

    (socketInfo: SocketInfo) => void

    • সকেটইনফো

      সকেটইনফো

      সকেট তথ্য ধারণকারী অবজেক্ট।

ফেরত

  • প্রতিশ্রুতি< সকেট তথ্য >

    ক্রোম ৯১+

    প্রমিস শুধুমাত্র ম্যানিফেস্ট ভি৩ এবং এর পরবর্তী সংস্করণগুলোতে সমর্থিত, অন্যান্য প্ল্যাটফর্মে কলব্যাক ব্যবহার করতে হবে।

getSockets()

প্রতিশ্রুতি
chrome.bluetoothSocket.getSockets(
  callback?: function,
): Promise<SocketInfo[]>

অ্যাপ্লিকেশনটির মালিকানাধীন বর্তমানে খোলা সকেটগুলোর তালিকা পুনরুদ্ধার করে।

প্যারামিটার

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    callback প্যারামিটারটি দেখতে এইরকম: 

    (sockets: SocketInfo[]) => void

    • সকেট

      সকেট তথ্য []

      সকেট তথ্য ধারণকারী অবজেক্টের অ্যারে।

ফেরত

  • প্রতিশ্রুতি< সকেট তথ্য []>

    ক্রোম ৯১+

    প্রমিস শুধুমাত্র ম্যানিফেস্ট ভি৩ এবং এর পরবর্তী সংস্করণগুলোতে সমর্থিত, অন্যান্য প্ল্যাটফর্মে কলব্যাক ব্যবহার করতে হবে।

listenUsingL2cap()

প্রতিশ্রুতি
chrome.bluetoothSocket.listenUsingL2cap(
  socketId: number,
  uuid: string,
  options?: ListenOptions,
  callback?: function,
): Promise<void>

L2CAP প্রোটোকল ব্যবহার করে সংযোগের জন্য অপেক্ষা করুন।

প্যারামিটার

  • সকেটআইডি

    সংখ্যা

    সকেট শনাক্তকারী।

  • uuid

    স্ট্রিং

    শোনার জন্য সার্ভিস UUID।

  • বিকল্পগুলি

    শোনার বিকল্পগুলি ঐচ্ছিক

    পরিষেবাটির জন্য ঐচ্ছিক অতিরিক্ত বিকল্পসমূহ।

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    callback প্যারামিটারটি দেখতে এইরকম: 

    () => void

ফেরত

  • প্রতিশ্রুতি<শূন্য>

    ক্রোম ৯১+

    প্রমিস শুধুমাত্র ম্যানিফেস্ট ভি৩ এবং এর পরবর্তী সংস্করণগুলোতে সমর্থিত, অন্যান্য প্ল্যাটফর্মে কলব্যাক ব্যবহার করতে হবে।

listenUsingRfcomm()

প্রতিশ্রুতি
chrome.bluetoothSocket.listenUsingRfcomm(
  socketId: number,
  uuid: string,
  options?: ListenOptions,
  callback?: function,
): Promise<void>

RFCOMM প্রোটোকল ব্যবহার করে সংযোগের জন্য অপেক্ষা করুন।

প্যারামিটার

  • সকেটআইডি

    সংখ্যা

    সকেট শনাক্তকারী।

  • uuid

    স্ট্রিং

    শোনার জন্য সার্ভিস UUID।

  • বিকল্পগুলি

    শোনার বিকল্পগুলি ঐচ্ছিক

    পরিষেবাটির জন্য ঐচ্ছিক অতিরিক্ত বিকল্পসমূহ।

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    callback প্যারামিটারটি দেখতে এইরকম: 

    () => void

ফেরত

  • প্রতিশ্রুতি<শূন্য>

    ক্রোম ৯১+

    প্রমিস শুধুমাত্র ম্যানিফেস্ট ভি৩ এবং এর পরবর্তী সংস্করণগুলোতে সমর্থিত, অন্যান্য প্ল্যাটফর্মে কলব্যাক ব্যবহার করতে হবে।

send()

প্রতিশ্রুতি
chrome.bluetoothSocket.send(
  socketId: number,
  data: ArrayBuffer,
  callback?: function,
): Promise<number>

প্রদত্ত ব্লুটুথ সকেটে ডেটা প্রেরণ করে।

প্যারামিটার

  • সকেটআইডি

    সংখ্যা

    সকেট শনাক্তকারী।

  • ডেটা

    অ্যারেবাফার

    প্রেরণ করার জন্য ডেটা।

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    callback প্যারামিটারটি দেখতে এইরকম: 

    (bytesSent: number) => void

    • bytesSent

      সংখ্যা

      প্রেরিত বাইটের সংখ্যা।

ফেরত

  • প্রতিশ্রুতি<সংখ্যা>

    ক্রোম ৯১+

    প্রমিস শুধুমাত্র ম্যানিফেস্ট ভি৩ এবং এর পরবর্তী সংস্করণগুলোতে সমর্থিত, অন্যান্য প্ল্যাটফর্মে কলব্যাক ব্যবহার করতে হবে।

setPaused()

প্রতিশ্রুতি
chrome.bluetoothSocket.setPaused(
  socketId: number,
  paused: boolean,
  callback?: function,
): Promise<void>

একটি সংযুক্ত সকেটকে তার পিয়ার থেকে বার্তা গ্রহণ করতে, অথবা একটি লিসেনিং সকেটকে নতুন সংযোগ গ্রহণ করতে সক্ষম বা অক্ষম করে। এর ডিফল্ট মান হলো "ফলস"। একটি সংযুক্ত সকেটকে পজ করা সাধারণত কোনো অ্যাপ্লিকেশন তার পিয়ার দ্বারা প্রেরিত ডেটার গতি নিয়ন্ত্রণ করতে ব্যবহার করে। যখন একটি সংযুক্ত সকেট পজ করা হয়, তখন কোনো onReceive ইভেন্ট তৈরি হয় না। যখন একটি সকেট সংযুক্ত থাকে এবং আন-পজ করা হয়, তখন বার্তা গ্রহণ করা হলে আবার onReceive ইভেন্ট তৈরি হয়। যখন একটি লিসেনিং সকেট পজ করা হয়, তখন তার ব্যাকলগ পূর্ণ না হওয়া পর্যন্ত নতুন সংযোগ গ্রহণ করা হয়, এরপর অতিরিক্ত সংযোগের অনুরোধ প্রত্যাখ্যান করা হয়। onAccept ইভেন্ট শুধুমাত্র তখনই তৈরি হয় যখন সকেটটি আন-পজ করা হয়।

প্যারামিটার

  • সকেটআইডি

    সংখ্যা

  • থামানো

    বুলিয়ান

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    callback প্যারামিটারটি দেখতে এইরকম: 

    () => void

ফেরত

  • প্রতিশ্রুতি<শূন্য>

    ক্রোম ৯১+

    প্রমিস শুধুমাত্র ম্যানিফেস্ট ভি৩ এবং এর পরবর্তী সংস্করণগুলোতে সমর্থিত, অন্যান্য প্ল্যাটফর্মে কলব্যাক ব্যবহার করতে হবে।

update()

প্রতিশ্রুতি
chrome.bluetoothSocket.update(
  socketId: number,
  properties: SocketProperties,
  callback?: function,
): Promise<void>

সকেটের বৈশিষ্ট্যগুলো আপডেট করে।

প্যারামিটার

  • সকেটআইডি

    সংখ্যা

    সকেট শনাক্তকারী।

  • বৈশিষ্ট্য

    সকেটপ্রপার্টিজ

    আপডেট করার জন্য প্রপার্টিগুলো।

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    callback প্যারামিটারটি দেখতে এইরকম: 

    () => void

ফেরত

  • প্রতিশ্রুতি<শূন্য>

    ক্রোম ৯১+

    প্রমিস শুধুমাত্র ম্যানিফেস্ট ভি৩ এবং এর পরবর্তী সংস্করণগুলোতে সমর্থিত, অন্যান্য প্ল্যাটফর্মে কলব্যাক ব্যবহার করতে হবে।

ইভেন্টগুলি

onAccept

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

কোনো নির্দিষ্ট সকেটের জন্য সংযোগ স্থাপিত হলে এই ইভেন্টটি সংঘটিত হয়।

প্যারামিটার

  • কলব্যাক

    ফাংশন

    callback প্যারামিটারটি দেখতে এইরকম: 

    (info: AcceptInfo) => void

onAcceptError

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

প্রদত্ত সকেটে নতুন সংযোগের জন্য রানটাইম অপেক্ষা করার সময় কোনো নেটওয়ার্ক ত্রুটি ঘটলে এই ইভেন্টটি উত্থাপিত হয়। একবার এই ইভেন্টটি উত্থাপিত হলে, সকেটটি paused অবস্থায় চলে যায় এবং এই সকেটের জন্য আর কোনো onAccept ইভেন্ট উত্থাপিত হয় না।

প্যারামিটার

  • কলব্যাক

    ফাংশন

    callback প্যারামিটারটি দেখতে এইরকম: 

    (info: AcceptErrorInfo) => void

onReceive

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

কোনো নির্দিষ্ট সকেটের জন্য ডেটা গৃহীত হলে এই ইভেন্টটি উত্থাপিত হয়।

প্যারামিটার

onReceiveError

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

রানটাইম সকেটে ডেটার জন্য অপেক্ষা করার সময় কোনো নেটওয়ার্ক ত্রুটি ঘটলে এই ইভেন্টটি উত্থাপিত হয়। একবার এই ইভেন্টটি উত্থাপিত হলে, সকেটটি paused অবস্থায় চলে যায় এবং এই সকেটের জন্য আর কোনো onReceive ইভেন্ট উত্থাপিত হয় না।

প্যারামিটার

  • কলব্যাক

    ফাংশন

    callback প্যারামিটারটি দেখতে এইরকম: 

    (info: ReceiveErrorInfo) => void