ডিভাইসের মধ্যে রেঞ্জ

Android 16 (API লেভেল 36) রেঞ্জিং মডিউল নিয়ে এসেছে, যা ডিভাইসের মধ্যে নিখুঁত রেঞ্জিংয়ের জন্য ইউনিফায়েড ও স্ট্যান্ডার্ডাইজড ইন্টারফেস প্রদান করে। আপনি প্রতিটি রেঞ্জিং প্রযুক্তি আলাদাভাবে ম্যানেজ না করেই পিয়ার ডিভাইসের দূরত্ব ও পজিশন পরিমাপ করতে এই API সারফেস ব্যবহার করতে পারবেন।

রেঞ্জিং মডিউল নিম্নলিখিত প্রযুক্তিগুলি সাপোর্ট করে:

রেঞ্জিং ক্ষমতা ও উপলভ্যতা

RangingManager ক্লাস, অ্যাপকে স্থানীয় ডিভাইসের মাধ্যমে কাজ করে এমন রেঞ্জিং প্রযুক্তি সম্পর্কে তথ্য প্রদান করে, এর পাশাপাশি প্রতিটি প্রযুক্তির উপলভ্যতা ও ক্ষমতা সম্পর্কেও জানায়। অ্যাপগুলি যেকোনও সমর্থিত প্রযুক্তির উপলভ্যতা বা ক্ষমতার যেকোনও পরিবর্তনের আপডেট পেতে একটি RangingCapabilitiesCallback ইন্টারফেস রেজিস্টার করতে পারে।

ডিভাইসের ভূমিকা

রেঞ্জিং সেশনে অংশগ্রহণকারী ডিভাইসকে অবশ্যই Android 17 (API লেভেল 37) এবং তার পরবর্তী ভার্সনে UWB ডাউনলিঙ্ক-TDoA সেশনের জন্য ইনিশিয়েটর, রেসপন্ডার বা ডাউনলিঙ্ক-TDoA ট্যাগ (DT-ট্যাগ) হতে হবে। ইনিশিয়েটর ডিভাইস এক বা একাধিক রেসপন্ডার ডিভাইসের সাথে রেঞ্জিং সেশন শুরু করে। রেসপন্ডার ডিভাইস একবারে শুধুমাত্র একজন ইনিশিয়েটরের রেঞ্জিং অনুরোধে সাড়া দেয়। UWB ডাউনলিঙ্ক টাইম ডিফারেন্স অফ অ্যারাইভাল (DL-TDoA) সেশনে, ডিভাইসটি একাধিক UWB অ্যাঙ্কর থেকে সিগন্যাল পেতে DEVICE_ROLE_DT_TAG ভূমিকা ব্যবহার করে। আপনি RangingPreference ক্লাসের সাথে রেঞ্জিং সেশনে কোনও নির্দিষ্ট ডিভাইসের জন্য ভূমিকা নির্দিষ্ট করতে পারেন।

সেশনের ধরন অনুযায়ী রেঞ্জ

ডিভাইসের মধ্যে রেঞ্জিং সেশন শুরু করার সময়, সেশনের জন্য প্যারামিটার এক্সচেঞ্জ করতে প্রায়ই আউট-অফ-ব্যান্ড (OOB) ডেটা ট্রান্সপোর্ট প্রতিষ্ঠা করতে হয়।

রেঞ্জিং মডিউল আপনার জন্য OOB নেগোসিয়েশন ম্যানেজ করতে পারে, তবে এটি কাস্টম OOB ইমপ্লিমেন্টেশনও সাপোর্ট করে।

ছবি ১. সেশনের ধরনের জন্য OOB ফ্লো।

ডিফল্ট OOB প্রয়োগ

এই সেশনের ধরন (RANGING_SESSION_OOB)-এ, রেঞ্জিং সেশন শুরু করার জন্য রেঞ্জিং মডিউল OOB নেগোসিয়েশন ম্যানেজ করে। অ্যাপের দেওয়া রেঞ্জিং সংক্রান্ত পছন্দের ভিত্তিতে এটি উপযুক্ত প্যারামিটার বেছে নেয় এবং দুটি ডিভাইসেই কাজ করে এমন উপযুক্ত প্রযুক্তি ব্যবহার করে। এই সেশনের ধরন স্ট্যান্ডার্ডাইজড OOB স্পেসিফিকেশন ব্যবহার করে। Android 16 QPR2 (API লেভেল ৩৬.১) ও তার পরবর্তী ভার্সনে, OobInitiatorRangingConfig.Builder-এ setRangingTechnologyFilter কল করার মাধ্যমে কোন প্রযুক্তি নিয়ে আলোচনা করা হবে তা ইনিশিয়েটররা সীমাবদ্ধ করতে পারবেন।

রেঞ্জিং মডিউল শুধুমাত্র OOB ডেটা ফর্ম্যাট এবং পিয়ার ডিভাইসের সাথে ইন্টার‍্যাক্ট করার জন্য ব্যবহার করা হবে এমন ক্রম নির্ধারণ করে। এটি পিয়ার ডিভাইস ডিসকভারি বা কানেকশন তৈরি করা ম্যানেজ করে না।

কাস্টম OOB প্রয়োগ করা

এই সেশনের ধরন (RANGING_SESSION_RAW) অনুযায়ী, অ্যাপটি রেঞ্জিং মডিউলের OOB ফ্লো বাইপাস করে এবং নিজস্ব OOB নেগোসিয়েশন ও প্যারামিটার ম্যানেজ করে। এর অর্থ হল, অ্যাপটিকে অবশ্যই নির্ধারণ করতে হবে যে পিয়ার ডিভাইস কোন প্রযুক্তি সমর্থন করে, রেঞ্জিং প্যারামিটার নিয়ে আলোচনা করতে হবে এবং রেঞ্জিং সেশন শুরু করতে হবে।

রেঞ্জিং সংক্রান্ত পছন্দ

রেঞ্জিং সেশনের জন্য বেছে নেওয়া প্যারামিটার নির্দিষ্ট করতে RangingPreference অবজেক্ট ব্যবহার করুন। এর মধ্যে নিম্নলিখিত বিষয়গুলি অন্তর্ভুক্ত:

  • ডিভাইসের ভূমিকা। এটি নির্দেশ করে যে ডিভাইসটি Android 17 (API লেভেল 37) এবং তার পরবর্তী ভার্সনে ইনিশিয়েটর, রেসপন্ডার নাকি DT-ট্যাগ।
  • রেঞ্জিং কনফিগারেশন। RangingConfig অবজেক্ট রেঞ্জিং সেশনের ধরন এবং রেঞ্জিং সেশন শুরু করার জন্য প্রয়োজনীয় অন্যান্য প্যারামিটার নির্দিষ্ট করে।
  • সেশন কনফিগারেশন। SessionConfig অবজেক্ট রেঞ্জিং সেশনে প্রয়োগ করার জন্য প্যারামিটার নির্দিষ্ট করে, যেমন পরিমাপের সীমা, সেন্সর ফিউশন, জিওফেন্স কনফিগারেশন এবং আরও অনেক কিছু। Android 17 (API লেভেল ৩৭) এবং তার পরবর্তী যেকোনও ভার্সনে, আপনি setAntennaMode-এর মাধ্যমে অ্যান্টেনা মোড (ANTENNA_MODE_DIRECTIONAL বা ANTENNA_MODE_OMNI) কনফিগার করতে পারবেন SessionConfig.Builder-এ getSupportedAntennaModes-এর মাধ্যমে কাজ করে এমন মোড চেক করার পরে UwbRangingCapabilities-এ।

রেঞ্জিং সংক্রান্ত অনুমতি

রেঞ্জিং মডিউল পিয়ার-টু-পিয়ার রেঞ্জিং প্রযুক্তির জন্য ইউনিফায়েড অনুমতি (android.permission.RANGING) ব্যবহার করে। এই অনুমতি NEARBY_DEVICES_PERMISSIONS তালিকায় আছে।

<uses-permission android:name="android.permission.RANGING" />

বিধিনিষেধ ও সীমাবদ্ধতা

রেঞ্জিং মডিউল বিভিন্ন কারণে রেঞ্জিং সীমাবদ্ধ করতে পারে, যার মধ্যে নিম্নলিখিতগুলি অন্তর্ভুক্ত:

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

এছাড়াও, রেঞ্জিং মডিউলের নিম্নলিখিত পরিচিত সীমাবদ্ধতা আছে:

  • রেঞ্জিং মডিউল শুধুমাত্র আল্ট্রা-ওয়াইডব্যান্ডের জন্য পিয়ার ডিভাইসে রেঞ্জিং ডেটা ডেলিভারি করতে পারে। অন্যান্য প্রযুক্তির ক্ষেত্রে, রেঞ্জিং মডিউল শুধুমাত্র ইনিশিয়েটর ডিভাইসে রেঞ্জিং ডেটা প্রদান করে।
  • রেঞ্জিং মডিউল শুধুমাত্র র রেঞ্জিং মোডে ডিভাইসের ডাইনামিক সংযোজন সমর্থন করে এবং শুধুমাত্র আল্ট্রা-ওয়াইডব্যান্ডের জন্য।
  • ডিফল্ট OOB ইমপ্লিমেন্টেশনের জন্য রেঞ্জিং মডিউল এক-থেকে-অনেক আল্ট্রা-ওয়াইডব্যান্ড সেশনকে সাপোর্ট করে না। আপনি একাধিক ডিভাইস হ্যান্ডেল পাস করলে, মডিউলটি আল্ট্রা-ওয়াইডব্যান্ড সাপোর্ট করে এমন প্রতিটি পিয়ার ডিভাইসের জন্য একটি ওয়ান-টু-ওয়ান সেশন তৈরি করে।

রেঞ্জিং সেশন পরিচালনা করা

রেঞ্জিং মডিউল ব্যবহার করে রেঞ্জিং সেশন পরিচালনা করতে, এই ধাপগুলি অনুসরণ করুন:

  1. সব ডিভাইসে Android 16 (API লেভেল 36) বা তার পরবর্তী যেকোনও ভার্সন চলছে কিনা তা যাচাই করুন।
  2. অ্যাপ ম্যানিফেস্টে android.permission.RANGING অনুমতির জন্য অনুরোধ করুন।
  3. রেঞ্জিং প্রযুক্তির ক্ষমতা ও উপলভ্যতা মূল্যায়ন করা।
  4. রেঞ্জিং অপারেশনের জন্য পিয়ার ডিভাইস খুঁজে নিন।
  5. রেঞ্জিং সেশনের ধরন-এ বর্ণিত সেশনের ধরনগুলির মধ্যে যেকোনও একটি ব্যবহার করে, আউট-অফ-ব্যান্ড এক্সচেঞ্জের জন্য একটি কানেকশন স্থাপন করুন।
  6. রেঞ্জিং শুরু করুন এবং ক্রমাগত রেঞ্জিং ডেটা সংগ্রহ করুন।
  7. রেঞ্জিং সেশন বন্ধ করুন।

নিম্নলিখিত কোড স্যাম্পেল ইনিশিয়েটর ও রেসপন্ডার, উভয় রোলের জন্য এইসব ধাপ দেখায়।

class RangingApp {

    // Starts a ranging session on the initiator side.
    fun startRangingInitiator(
        context: Context,
        deviceHandle: DeviceHandle,
        executor: Executor,
        callback: RangingSession.Callback
    ): RangingSession? {

        // Get the RangingManager which is the entry point for ranging module.
        val manager = context.getSystemService(RangingManager::class.java)

        // Create a new RangingSession using the provided executor and callback.
        val session = manager.createRangingSession(executor, callback) ?: return null

        // Create an OobInitiatorRangingConfig, which specifies the ranging parameters for
        // the initiator role.
        val config = OobInitiatorRangingConfig.Builder()
            .setFastestRangingInterval(Duration.ofMillis(100))
            .setSlowestRangingInterval(Duration.ofMillis(5000))
            .setRangingMode(RANGING_MODE_AUTO)
            .setSecurityLevel(SECURITY_LEVEL_BASIC)
            .addDeviceHandle(deviceHandle)
            .build()

        // Create a RangingPreference, which specifies the role (initiator) and
        // configuration for the ranging session.
        val preference =
            RangingPreference.Builder(DEVICE_ROLE_INITIATOR, config).build()

        // Start ranging session. Ranging data is delivered asynchronously through
        // callback.onResults; call stopRanging(session) when ranging is no longer needed.
        session.start(preference)
        return session
    }

    // Starts a ranging session on the responder side.
    fun startRangingResponder(
        context: Context,
        deviceHandle: DeviceHandle,
        executor: Executor,
        callback: RangingSession.Callback
    ): RangingSession? {

        // Get the RangingManager which is the entry point for ranging module.
        val manager = context.getSystemService(RangingManager::class.java)

        // Create a new RangingSession using the provided executor and callback.
        val session = manager.createRangingSession(executor, callback) ?: return null

        // Create an OobResponderRangingConfig, which specifies the ranging parameters for
        // the responder role.
        val config = OobResponderRangingConfig.Builder(deviceHandle).build()

        // Create a RangingPreference, which specifies the role (responder) and
        // configuration for the ranging session.
        val preference =
            RangingPreference.Builder(DEVICE_ROLE_RESPONDER, config).build()

        // Start the ranging session. Call stopRanging(session) when finished.
        session.start(preference)
        return session
    }

    // Stops an active ranging session.
    fun stopRanging(session: RangingSession) {
        session.stop()
    }
}

রেঞ্জিং ফলাফল ও পিয়ার মোশন ম্যানেজ করা

সেশন অ্যাক্টিভ থাকলে, RangingSession.Callback onResults-এর মাধ্যমে RangingData অবজেক্টে দূরত্ব ও অ্যাঙ্গেল-অফ-অ্যারাইভাল পরিমাপ ডেলিভার করে:

  • দূরত্ব সংক্রান্ত অনিশ্চয়তা। Android 16 QPR2 (API লেভেল 36.1) এবং এর পরবর্তী ভার্সনে, দূরত্ব পরিমাপের স্ট্যান্ডার্ড ডেভিয়েশন উপলভ্য থাকলে তা পরীক্ষা করতে, RangingData-এ hasDistanceStandardDeviation এবং getDistanceStandardDeviationMeters কল করুন।
  • প্রযুক্তি-নির্দিষ্ট অতিরিক্ত সুবিধা। Android 17 (API লেভেল 37) এবং তার পরবর্তী যেকোনও ভার্সনে, RangingData-এ getRangingDataExtras কল করুন যাতে প্রযুক্তি-নির্দিষ্ট মেটাডেটা সহ RangingDataExtras অবজেক্ট ফিরিয়ে আনা যায়, যেমন BleSpecificData, UwbSpecificData বা WifiRttSpecificData।
  • পিয়ার মোশন স্টেট। Android 17 (API লেভেল 37) এবং তার পরবর্তী ভার্সনে, পিয়ার ডিভাইসের মুভমেন্ট পরিবর্তন হলে, MotionState আপডেট (MOTION_NOT_DETECTED, MOTION_SLIGHT, MOTION_MODERATE, অথবা MOTION_LARGE) পেতে, RangingSession.Callback-এ onMotionReceived ওভাররাইড করুন।

iOS ডিভাইসের সাথে UWB ইন্টারঅপারেবিলিটি

রেঞ্জিং মডিউল আল্ট্রা-ওয়াইডব্যান্ড (UWB) ব্যবহার করে iOS ডিভাইসের সাথে ইন্টারঅপারেবিলিটি সাপোর্ট করে। iOS ডিভাইসের সাথে রেঞ্জিং করতে, আপনাকে অবশ্যই একটি কাস্টম OOB ইমপ্লিমেন্টেশন ব্যবহার করতে হবে এবং নির্দিষ্ট প্যারামিটার সহ রেঞ্জিং সেশন কনফিগার করতে হবে যা Apple Nearby Interaction Accessory Protocol-এর সাথে মেলে। উদাহরণ হিসেবে, স্যাম্পেল অ্যাপ দেখুন।

RangingPreference তৈরি করার সময়, কনফিগারেশন নির্দিষ্ট করতে RawRangingDevice এবং UwbRangingParams ব্যবহার করুন। iOS ইন্টারঅপারেবিলিটির জন্য নিম্নলিখিত প্যারামিটারগুলি গুরুত্বপূর্ণ:

  • কনফিগারেশন আইডি। UwbRangingParams.CONFIG_UNICAST_DS_TWR ব্যবহার করুন।
  • সেশন কী সংক্রান্ত তথ্য। ভেন্ডর আইডি ও স্ট্যাটিক STS IV সহ বাইট অ্যারে প্রদান করুন।
  • জটিল চ্যানেল। iOS ডিভাইসের কনফিগারেশনের সাথে ম্যাচ করতে চ্যানেলের নম্বর ও প্রারম্ভিক নির্দেশাবলীর ইন্ডেক্স সেট করুন।

নিম্নলিখিত কোড স্নিপেট থেকে জানা যায় যে iOS রেসপন্ডারের সাথে রেঞ্জিং করা ইনিশিয়েটর ডিভাইসের জন্য কীভাবে RangingPreference তৈরি করতে হয়:

// Create UwbRangingParams with iOS-specific configuration.
val uwbRangingParams = UwbRangingParams.Builder(
    sessionId,
    UwbRangingParams.CONFIG_UNICAST_DS_TWR,
    sourceAddress,
    destinationAddress
)
    .setComplexChannel(
        UwbComplexChannel.Builder()
            .setChannel(channelNumber)
            .setPreambleIndex(preambleIndex)
            .build()
    )
    .setRangingUpdateRate(updateRate)
    .setSessionKeyInfo(sessionKeyInfo) // Vendor ID + STS IV
    .setSlotDuration(slotDuration)
    .build()

// Create RawRangingDevice.
val rawRangingDevice = RawRangingDevice.Builder()
    .setRangingDevice(RangingDevice.Builder().build())
    .setUwbRangingParams(uwbRangingParams)
    .build()

// Create SessionConfig.
val sessionConfig = SessionConfig.Builder()
    .setAngleOfArrivalNeeded(true)
    .setDataNotificationConfig(
        DataNotificationConfig.Builder()
            .setNotificationConfigType(DataNotificationConfig.NOTIFICATION_CONFIG_ENABLE)
            .build()
    )
    .build()

// Create RangingPreference for the initiator.
val preference = RangingPreference.Builder(
    RangingPreference.DEVICE_ROLE_INITIATOR,
    RawInitiatorRangingConfig.Builder()
        .addRawRangingDevice(rawRangingDevice)
        .build()
)
    .setSessionConfig(sessionConfig)
    .build()

UWB Downlink-TDoA API

Android 17 (API লেভেল 37) এবং তার পরবর্তী ভার্সনে, ডাউনলিঙ্ক টাইম ডিফারেন্স অফ অ্যারাইভাল (DL-TDoA) রেঞ্জিং কোনও ডিভাইসকে সিগন্যালের আপেক্ষিক আগমনের সময় পরিমাপ করে একাধিক UWB অ্যাঙ্করের সাপেক্ষে তার অবস্থান নির্ধারণ করতে দেয়।

DL-TDoA সাপোর্ট যাচাই করতে, সেশন শুরু করার জন্য DlTdoaRangingParams ও RawDtTagRangingConfig কনফিগার করতে এবং DlTdoaMeasurement ফলাফল পেতে কীভাবে RangingManager ব্যবহার করতে হয় তা নিম্নলিখিত স্নিপেট থেকে জানতে পারবেন:

class RangingApp {

    fun initDlTdoa(context: Context) {
        // Initialize the Ranging Manager.
        val rangingManager = context.getSystemService(RangingManager::class.java)

        // Register for device capabilities.
        val capabilitiesCallback = object : RangingManager.RangingCapabilitiesCallback {
            override fun onRangingCapabilities(capabilities: RangingCapabilities) {
                // Make sure DL-TDoA is supported before starting the session.
                if (capabilities.uwbCapabilities?.isDlTdoaSupported == true) {
                    startDlTDoASession(context)
                }
            }
        }
        rangingManager.registerCapabilitiesCallback(Executors.newSingleThreadExecutor(), capabilitiesCallback)
    }

    fun startDlTDoASession(context: Context) {
        // Initialize the Ranging Manager.
        val rangingManager = context.getSystemService(RangingManager::class.java)

        // Create session and configure parameters.
        val executor = Executors.newSingleThreadExecutor()
        val rangingSession = rangingManager.createRangingSession(executor, RangingSessionCallback())
        val rangingRoundIndexes = byteArrayOf(0)
        val config: ByteArray = byteArrayOf() // OOB config data
        val params = DlTdoaRangingParams.createFromFiraConfigPacket(config, rangingRoundIndexes)

        val rangingDevice = RangingDevice.Builder().build()
        val rawTagDevice = RawRangingDevice.Builder()
            .setRangingDevice(rangingDevice)
            .setDlTdoaRangingParams(params)
            .build()

        val dtTagConfig = RawDtTagRangingConfig.Builder(rawTagDevice).build()

        val preference = RangingPreference.Builder(DEVICE_ROLE_DT_TAG, dtTagConfig)
            .setSessionConfig(SessionConfig.Builder().build())
            .build()

        // Start the ranging session.
        rangingSession?.start(preference)
    }
}

private class RangingSessionCallback : RangingSession.Callback {
    override fun onDlTdoaResults(peer: RangingDevice, measurement: DlTdoaMeasurement) {
        // Process measurement results here.
    }

    override fun onOpened() {
        // ...
    }

    override fun onOpenFailed(reason: Int) {
        // ...
    }

    override fun onStarted(peer: RangingDevice, technology: Int) {
        // ...
    }

    override fun onStopped(peer: RangingDevice, technology: Int) {
        // ...
    }

    override fun onResults(peer: RangingDevice, data: RangingData) {
        // ...
    }

    override fun onClosed(reason: Int) {
        // ...
    }
}

আউট-অফ-ব্যান্ড (OOB) কনফিগারেশন

নিম্নলিখিত স্নিপেট ওয়াই-ফাই ও BLE-এর জন্য DL-TDoA OOB কনফিগারেশন ডেটার উদাহরণ প্রদান করে:

// Wi-Fi Configuration (Vendor-Specific IE, FiRa CID 0x5A18FF, Config 0)
val wifiConfig = byteArrayOf(
    0xDD.toByte(), 0x30, 0x5A, 0x18, 0xFF.toByte(), // Wi-Fi VSE Header
    0x5F, 0x1C, // UWB Configuration Sub-Element
    0x02, 0x00, // Profile ID (Untracked Navigation), Config ID 0
    0x06, 0x02, 0x20, 0x08, // Device MAC Address
    0x14, 0x01, 0x0A, // Preamble Code Index (10)
    0x27, 0x02, 0x08, 0x07, // Vendor ID
    0x28, 0x06, 0xA1.toByte(), 0xB2.toByte(), 0xC3.toByte(), 0xD4.toByte(), 0xE5.toByte(), 0xF6.toByte(), // Static STS IV
    0x08, 0x02, 0x60, 0x09, // Slot Duration (2400 RSTU = 2 ms)
    0x1B, 0x01, 0x0A, // Slots per Ranging Round (10)
    0x09, 0x04, 0xFA.toByte(), 0x00, 0x00, 0x00, // Ranging Duration (250 ms)
    0x52, 0x01, 0x00, // Initiator DT-Anchor Round Index (0)
    0x9F.toByte(), 0x04, 0xAA.toByte(), 0xBB.toByte(), 0xCC.toByte(), 0xDD.toByte() // Session ID (0xDDCCBBAA)
)

// BLE Configuration (ADV_NONCONN_IND Service Data UUID 0xFFF3, Config 0)
val bleConfig = byteArrayOf(
    0x1E, 0x16, 0xF3.toByte(), 0xFF.toByte(), // BLE Service Data Header
    0xF0.toByte(), // Fragment Indication Sub-Element (unfragmented)
    0x5F, 0x09, // UWB Configuration Sub-Element
    0x02, 0x00, // Profile ID (Untracked Navigation), Config ID 0
    0x06, 0x02, 0x20, 0x08, // Device MAC Address
    0x27, 0x02, 0x08, 0x07, // Vendor ID
    0x28, 0x06, 0xA1.toByte(), 0xB2.toByte(), 0xC3.toByte(), 0xD4.toByte(), 0xE5.toByte(), 0xF6.toByte(), // Static STS IV
    0x9F.toByte(), 0x04, 0xAA.toByte(), 0xBB.toByte(), 0xCC.toByte(), 0xDD.toByte() // Session ID (0xDDCCBBAA)
)

OOB কনফিগারেশন না থাকার কারণে আপনি সেটি ব্যবহার করতে না পারলে অথবা OOB কনফিগারেশনে নেই এমন ডিফল্ট ভ্যালু পরিবর্তন করতে হলে, DlTdoaRangingParams.createFromFiraConfigPacket কল করার পরিবর্তে DlTdoaRangingParams.Builder-এর মাধ্যমে প্যারামিটার তৈরি করতে পারবেন:

val dlTdoaParams = DlTdoaRangingParams.Builder(1)
    .setComplexChannel(
        UwbComplexChannel.Builder()
            .setChannel(9).setPreambleIndex(10).build()
    )
    .setDeviceAddress(deviceAddress)
    .setSessionKeyInfo(byteArrayOf(0x01, 0x02, 0x03, 0x04))
    .setRangingIntervalMillis(240)
    .setSlotDuration(UwbRangingParams.DURATION_2_MS)
    .setSlotsPerRangingRound(20)
    .setRangingRoundIndexes(byteArrayOf(0x01, 0x05))
    .build()

স্যাম্পেল অ্যাপ

রেঞ্জিং মডিউল কীভাবে ব্যবহার করতে হয় তার এন্ড-টু-এন্ড উদাহরণ দেখতে, AOSP-তে স্যাম্পেল অ্যাপ দেখুন। এই স্যাম্পেল অ্যাপে রেঞ্জিং মডিউল দ্বারা সমর্থিত সব রেঞ্জিং প্রযুক্তি কভার করা হয় এবং এতে সমর্থিত সেশনের দুই ধরনের ফ্লো অন্তর্ভুক্ত থাকে।

iOS ডিভাইসের সাথে UWB ইন্টারঅপারেবিলিটি

Android স্যাম্পেল অ্যাপ, iOS স্যাম্পেল অ্যাপ-এর সাথে UWB রেঞ্জিং সেশন শুরু করার সুবিধা প্রদান করে।

ছবি ২. Android ও iOS UWB ব্যবহার।