ডিভাইস ডিসকভারি API

প্রায় প্রতিটি মাল্টি-ডিভাইস অভিজ্ঞতা শুরু হয় উপলভ্য ডিভাইস খোঁজার মাধ্যমে। এই সাধারণ টাস্কটি সহজ করতে, আমরা ডিভাইস ডিসকভারি API অফার করি।

আশেপাশের ব্যবহারকারীদের সাথে শেয়ার করার বিকল্প সহ ডায়ালগ বক্স
ছবি ১: আশেপাশের ব্যবহারকারীদের সাথে শেয়ার করুন।

ডিভাইস বেছে নেওয়ার ডায়ালগ চালু করুন

ব্যবহারকারীকে টার্গেট ডিভাইস বেছে নিতে দেওয়ার জন্য ডিভাইস ডিসকভারি সিস্টেম ডায়ালগ ব্যবহার করে। ডিভাইস বাছাই করার ডায়ালগ শুরু করতে, আপনাকে প্রথমে ডিভাইস ডিসকভারি ক্লায়েন্ট পেতে হবে এবং ফলাফল রিসিভার রেজিস্টার করতে হবে। মনে রাখবেন, registerForActivityResult-এর মতো এই রিসিভারকে অ্যাক্টিভিটি বা ফ্র্যাগমেন্ট ইনিশিয়ালাইজেশন পাথের অংশ হিসেবে নিঃশর্তভাবে রেজিস্টার করতে হবে।

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
  super.onCreate(savedInstanceState)
  devicePickerLauncher = Discovery.create(this).registerForResult(this, handleDevices)
}

জাভা

@Override
public void onCreate(@Nullable Bundle savedInstanceState) {
  super.onCreate(savedInstanceState);
  devicePickerLauncher = Discovery.create(this).registerForResult(this, handleDevices);
}

উপরের কোড স্নিপেটে, আমাদের কাছে একটি অনির্ধারিত handleDevices অবজেক্ট আছে। ব্যবহারকারী কানেক্ট করার জন্য ডিভাইস বেছে নেওয়ার পরে এবং SDK অন্য ডিভাইসের সাথে সফলভাবে কানেক্ট হয়ে গেলে, এই কলব্যাক Participants-এর তালিকা পায়।

Kotlin

handleDevices = OnDevicePickerResultListener { participants -> participants.forEach {
    // Use participant info
  }
}

জাভা

handleDevices = participants -> {
   for (Participant participant : participants) {
      // Use participant info
   }
}

ডিভাইস পিকার রেজিস্টার করার পরে, devicePickerLauncher ইনস্ট্যান্স ব্যবহার করে এটি লঞ্চ করুন। DevicePickerLauncher.launchDevicePicker-এ দুটি প্যারামিটার থাকে – ডিভাইস ফিল্টারের একটি তালিকা (নিচের বিভাগ দেখুন) এবং একটি startComponentRequest। startComponentRequest ব্যবহার করা হয় রিসিভ করা ডিভাইসে কোন অ্যাক্টিভিটি শুরু করা উচিত তা নির্দেশ করতে এবং ব্যবহারকারীকে দেখানো অনুরোধের কারণ জানাতে।

Kotlin

devicePickerLauncher.launchDevicePicker(
  listOf(),
  startComponentRequest {
    action = "com.example.crossdevice.MAIN"
    reason = "I want to say hello to you"
  },
)

জাভা

devicePickerLauncher.launchDevicePickerFuture(
    Collections.emptyList(),
    new StartComponentRequest.Builder()
        .setAction("com.example.crossdevice.MAIN")
        .setReason("I want to say hello to you")
        .build());

কানেকশন সংক্রান্ত অনুরোধ গ্রহণ করুন

ব্যবহারকারী ডিভাইস পিকার থেকে কোনও ডিভাইস বেছে নিলে, যে ডিভাইসটি ডেটা গ্রহণ করছে সেটিতে একটি ডায়ালগ দেখানো হয়। এর মাধ্যমে ব্যবহারকারীকে কানেকশন গ্রহণ করার জন্য বলা হয়। গ্রহণ করা হলে, টার্গেট অ্যাক্টিভিটি লঞ্চ করা হয়, যা onCreate এবং onNewIntent-এ ম্যানেজ করা যেতে পারে।

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
  super.onCreate(savedInstanceState)
  handleIntent(getIntent())
}

override fun onNewIntent(intent: Intent) {
  super.onNewIntent(intent)
  handleIntent(intent)
}

private fun handleIntent(intent: Intent) {
  val participant = Discovery.create(this).getParticipantFromIntent(intent)
  // Accept connection from participant (see below)
}

জাভা

@Override
public void onCreate(@Nullable Bundle savedInstanceState) {
  super.onCreate(savedInstanceState);
  handleIntent(getIntent());
}

@Override
public void onNewIntent(Intent intent) {
  super.onNewIntent(intent);
  handleIntent(intent);
}

private void handleIntent(Intent intent) {
  Participant participant = Discovery.create(this).getParticipantFromIntent(intent);
  // Accept connection from participant (see below)
}

ডিভাইসের ফিল্টার

ডিভাইস খোঁজার সময়, এই ডিভাইসগুলিকে ফিল্টার করে শুধুমাত্র প্রাসঙ্গিক ডিভাইসগুলি দেখানোর প্রয়োজন হতে পারে। যেমন:

  • QR কোড স্ক্যান করতে সাহায্য করার জন্য শুধুমাত্র ক্যামেরা সহ ডিভাইস ফিল্টার করা হচ্ছে
  • বড় স্ক্রিনে দেখার অভিজ্ঞতা পেতে শুধুমাত্র টিভিতে ফিল্টার করা হচ্ছে

এই ডেভেলপার প্রিভিউয়ের জন্য, আমরা একই ব্যবহারকারীর মালিকানাধীন ডিভাইসে ফিল্টার করার ক্ষমতা দিয়ে শুরু করছি।

আপনি ক্লাস DeviceFilter ব্যবহার করে ডিভাইস ফিল্টার নির্দিষ্ট করতে পারেন:

Kotlin

val deviceFilters = listOf(DeviceFilter.trustRelationshipFilter(MY_DEVICES_ONLY))

জাভা

List<DeviceFilter> deviceFilters =
    Arrays.asList(DeviceFilter.trustRelationshipFilter(MY_DEVICES_ONLY));

আপনি ডিভাইস ফিল্টার নির্ধারণ করার পরে, ডিভাইস খোঁজা শুরু করতে পারবেন।

Kotlin

devicePickerLauncher.launchDevicePicker(deviceFilters, startComponentRequest)

জাভা

Futures.addCallback(
    devicePickerLauncher.launchDevicePickerFuture(deviceFilters, startComponentRequest),
    new FutureCallback<Void>() {
      @Override
      public void onSuccess(Void result) {
        // do nothing, result will be returned to handleDevices callback
      }

      @Override
      public void onFailure(Throwable t) {
        // handle error
      }
    },
    mainExecutor);

লক্ষ্য করুন যে launchDevicePicker হল একটি অ্যাসিঙ্ক্রোনাস ফাংশন যা suspend কীওয়ার্ড ব্যবহার করে।