Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

सुविधाएं और एपीआई

Android 17 में डेवलपर के लिए, कई नई सुविधाएं और एपीआई उपलब्ध कराए गए हैं. यहां दिए गए सेक्शन में, इन सुविधाओं के बारे में खास जानकारी दी गई है. इससे आपको इनसे जुड़े एपीआई का इस्तेमाल शुरू करने में मदद मिलेगी.

नए, बदले गए, और हटाए गए एपीआई की पूरी सूची देखने के लिए, एपीआई में हुए बदलावों की जानकारी देने वाली रिपोर्ट पढ़ें. नए एपीआई के बारे में ज़्यादा जानने के लिए, Android API रेफ़रंस पर जाएं. नए एपीआई को हाइलाइट किया गया है, ताकि वे आसानी से दिख सकें.

आपको उन क्षेत्रों की भी समीक्षा करनी चाहिए जहां प्लैटफ़ॉर्म में हुए बदलावों से आपके ऐप्लिकेशन पर असर पड़ सकता है. ज़्यादा जानकारी के लिए, ये पेज देखें:

मुख्य फ़ंक्शन

Android 17 में, Android की मुख्य सुविधाओं से जुड़ी ये नई सुविधाएं जोड़ी गई हैं.

ProfilingManager के नए ट्रिगर

Android 17 में, ProfilingManager में कई नए सिस्टम ट्रिगर जोड़े गए हैं. इनकी मदद से, परफ़ॉर्मेंस से जुड़ी समस्याओं को डीबग करने के लिए, अहम डेटा इकट्ठा किया जा सकता है.

नए ट्रिगर ये हैं:

TRIGGER_TYPE_COLD_START: यह ट्रिगर, ऐप्लिकेशन के कोल्ड स्टार्ट के दौरान चालू होता है. यह जवाब में, कॉल स्टैक का सैंपल और सिस्टम ट्रेस, दोनों उपलब्ध कराता है.
TRIGGER_TYPE_OOM: यह ट्रिगर तब चालू होता है, जब कोई ऐप्लिकेशन OutOfMemoryError दिखाता है. साथ ही, जवाब में Java Heap Dump उपलब्ध कराता है.
TRIGGER_TYPE_KILL_EXCESSIVE_CPU_USAGE: यह ट्रिगर तब चालू होता है, जब किसी ऐप्लिकेशन को सीपीयू के असामान्य और ज़्यादा इस्तेमाल की वजह से बंद कर दिया जाता है. साथ ही, जवाब में कॉल स्टैक का सैंपल उपलब्ध कराता है.
TRIGGER_TYPE_ANOMALY: इससे सिस्टम की परफ़ॉर्मेंस से जुड़ी गड़बड़ियों का पता लगाया जा सकता है. जैसे, बाइंडर कॉल की संख्या ज़्यादा होना और मेमोरी का ज़्यादा इस्तेमाल होना.

सिस्टम ट्रिगर सेट अप करने का तरीका जानने के लिए, ट्रिगर पर आधारित प्रोफ़ाइलिंग और प्रोफ़ाइलिंग डेटा को वापस पाने और उसका विश्लेषण करने के तरीके से जुड़ा दस्तावेज़ देखें.

ऐप्लिकेशन में गड़बड़ियों की प्रोफ़ाइलिंग करने वाला ट्रिगर

Android 17 में, डिवाइस पर गड़बड़ी का पता लगाने वाली एक सेवा शुरू की गई है. यह सेवा, ज़्यादा संसाधनों का इस्तेमाल करने वाले व्यवहार और संभावित कंपैटिबिलिटी रिग्रेशन पर नज़र रखती है. ProfilingManager के साथ इंटिग्रेट की गई इस सेवा की मदद से, आपका ऐप्लिकेशन, सिस्टम से पता लगाए गए खास इवेंट की वजह से ट्रिगर होने वाले प्रोफ़ाइलिंग आर्टफ़ैक्ट पा सकता है.

TRIGGER_TYPE_ANOMALY ट्रिगर का इस्तेमाल करके, सिस्टम की परफ़ॉर्मेंस से जुड़ी समस्याओं का पता लगाया जा सकता है. जैसे, बाइंडर कॉल की संख्या ज़्यादा होना और मेमोरी का ज़्यादा इस्तेमाल होना. जब कोई ऐप्लिकेशन, ओएस की तय की गई मेमोरी की सीमाओं को तोड़ता है, तो गड़बड़ी का पता लगाने वाला ट्रिगर, डेवलपर को ऐप्लिकेशन के लिए खास Heap Dumps पाने की अनुमति देता है. इससे उन्हें मेमोरी से जुड़ी समस्याओं की पहचान करने और उन्हें ठीक करने में मदद मिलती है. इसके अलावा, बाइंडर स्पैम की संख्या ज़्यादा होने पर, गड़बड़ी का पता लगाने वाला ट्रिगर, बाइंडर लेन-देन पर स्टैक सैंपलिंग प्रोफ़ाइल उपलब्ध कराता है.

एपीआई कॉलबैक, सिस्टम की ओर से लागू किए गए किसी भी एनफ़ोर्समेंट से पहले होता है. उदाहरण के लिए, इससे डेवलपर को डीबग डेटा इकट्ठा करने में मदद मिल सकती है. यह डेटा, ऐप्लिकेशन को मेमोरी की सीमाओं से ज़्यादा इस्तेमाल करने की वजह से सिस्टम से बंद किए जाने से पहले इकट्ठा किया जा सकता है.

val profilingManager =
    applicationContext.getSystemService(ProfilingManager::class.java)
val triggers = ArrayList<ProfilingTrigger>()
triggers.add(ProfilingTrigger.Builder(ProfilingTrigger.TRIGGER_TYPE_ANOMALY))
val mainExecutor: Executor = Executors.newSingleThreadExecutor()
val resultCallback = Consumer<ProfilingResult> { profilingResult ->
    if (profilingResult.errorCode != ProfilingResult.ERROR_NONE) {
        // upload profile result to server for further analysis
        setupProfileUploadWorker(profilingResult.resultFilePath)
    }
    profilingManager.registerForAllProfilingResults(mainExecutor,
                                                    resultCallback)
    profilingManager.addProfilingTriggers(triggers)
}

JobDebugInfo API

Android 17 引入了新的 JobDebugInfo API，可帮助开发者调试其 JobScheduler 作业，了解作业未运行的原因、运行时长以及其他汇总信息。

扩展后的 JobDebugInfo API 的第一个方法是 getPendingJobReasonStats()，该方法会返回一个映射，其中包含作业处于待执行状态的原因及其各自的累计待执行时长。此方法将 getPendingJobReasonsHistory() 和 getPendingJobReasons() 方法联接在一起，可让您了解预定作业未按预期运行的原因，但通过在单个方法中同时提供时长和作业原因，简化了信息检索。

例如，对于指定的 jobId，该方法可能会返回 PENDING_JOB_REASON_CONSTRAINT_CHARGING 和 60000 毫秒的时长，表示作业因未满足充电约束而处于等待状态 60000 毫秒。

allow-while-idle अलार्म के लिए लिसनर की सुविधा का इस्तेमाल करके, वेक लॉक कम करें

Android 17 में, AlarmManager.setExactAndAllowWhileIdle का नया वैरिएंट पेश किया गया है. यह PendingIntent के बजाय OnAlarmListener को स्वीकार करता है. यह नया कॉलबैक-आधारित सिस्टम, उन ऐप्लिकेशन के लिए सबसे सही है जो समय-समय पर टास्क पूरे करने के लिए, लगातार वेकलॉक पर निर्भर रहते हैं. जैसे, सॉकेट कनेक्शन बनाए रखने वाले मैसेजिंग ऐप्लिकेशन.

निजता

Android 17 में, उपयोगकर्ता की निजता को बेहतर बनाने के लिए ये नई सुविधाएं शामिल हैं.

Encrypted Client Hello (ECH) प्लैटफ़ॉर्म के लिए सहायता

Android 17 引入了对加密客户端 Hello (ECH) 的平台支持，这是对网络通信的一项重大隐私增强功能。ECH 是一项 TLS 1.3 扩展，可在初始 TLS 握手期间加密服务器名称指示 (SNI)。这种加密有助于保护用户隐私，因为它可以让网络中介更难识别应用连接到的特定网域。

该平台现在包含网络库实现 ECH 所需的 API。这包括 DnsResolver 中的新功能，用于查询包含 ECH 配置的 HTTPS DNS 记录；以及 Conscrypt 的 SSLEngine 和 SSLSocket 中的新方法，用于在连接到网域时传入这些配置来启用 ECH。开发者可以通过网络安全配置文件中的新 <domainEncryption> 元素来配置 ECH 偏好设置，例如机会性地启用 ECH 或强制使用 ECH，这些设置可全局应用，也可按网域应用。

预计 HttpEngine、WebView 和 OkHttp 等热门联网库将在未来的更新中集成这些平台 API，从而使应用能够更轻松地采用 ECH 并增强用户隐私保护。

如需了解详情，请参阅加密的客户端 Hello 文档。

Android कॉन्टैक्ट पिकर

The Android Contact Picker is a standardized, browsable interface for users to share contacts with your app. Available on devices running Android 17 (API level 37) or higher, the picker offers a privacy-preserving alternative to the broad READ_CONTACTS permission. Instead of requesting access to the user's entire address book, your app specifies the data fields it needs, such as phone numbers or email addresses, and the user selects specific contacts to share. This grants your app read access to only the selected data, ensuring granular control while providing a consistent user experience with built-in search, profile switching, and multi-selection capabilities without having to build or maintain the UI.

For more information, see the contact picker documentation.

सुरक्षा

Android 17 में, डिवाइस और ऐप्लिकेशन की सुरक्षा को बेहतर बनाने के लिए ये नई सुविधाएं जोड़ी गई हैं.

Android का ऐडवांस सुरक्षा मोड (एएपीएम)

Android Advanced Protection Mode offers Android users a powerful new set of security features, marking a significant step in safeguarding users—particularly those at higher risk—from sophisticated attacks. Designed as an opt-in feature, AAPM is activated with a single configuration setting that users can turn on at any time to apply an opinionated set of security protections.

These core configurations include blocking app installation from unknown sources (sideloading), restricting USB data signaling, and mandating Google Play Protect scanning, which significantly reduces the device's attack surface area. Developers can integrate with this feature using the AdvancedProtectionManager API to detect the mode's status, enabling applications to automatically adopt a hardened security posture or restrict high-risk functionality when a user has opted in.

PQC APK Signing

Android 现在支持混合 APK 签名方案，以保护应用的签名身份免受利用量子计算的攻击的潜在威胁。此功能引入了一种新的 APK 签名方案，可让您将经典签名密钥（例如 RSA 或 EC）与新的后量子加密 (PQC) 算法 (ML-DSA) 配对。

这种混合方法可确保您的应用在未来免受量子攻击，同时与依赖于经典签名验证的旧版 Android 和设备保持完全的向后兼容性。

对开发者的影响

使用 Play 应用签名的应用：如果您使用 Play 应用签名，可以等待 Google Play 为您提供使用 Google Play 生成的 PQC 密钥升级混合签名的选项，从而确保您的应用受到保护，而无需手动管理密钥。
使用自行管理的密钥的应用：自行管理签名密钥的开发者可以利用更新后的 Android build 工具（例如 apksigner）轮换到混合身份，将 PQC 密钥与新的经典密钥相结合。（您必须创建新的经典密钥，无法重复使用旧密钥。）

कनेक्टिविटी

Android 17 में, डिवाइस और ऐप्लिकेशन की कनेक्टिविटी को बेहतर बनाने के लिए ये सुविधाएं जोड़ी गई हैं.

सैटलाइट नेटवर्क की उपलब्धता सीमित होना

实现优化，使应用能够在低带宽卫星网络上有效运行。

उपयोगकर्ता अनुभव और सिस्टम यूज़र इंटरफ़ेस (यूआई)

Android 17 में, उपयोगकर्ता अनुभव को बेहतर बनाने के लिए ये बदलाव किए गए हैं.

Assistant की आवाज़ के लिए अलग वॉल्यूम स्ट्रीम

Android 17 为 Google 助理应用引入了专用的 Google 助理音量流，以便使用 USAGE_ASSISTANT 进行播放。此项更改将 Google 助理音频与标准媒体流分离，让用户可以单独控制这两个音量。这样便可实现以下场景：将媒体播放静音，同时保持 Google 助理响应的可听性，反之亦然。

有权访问新的 MODE_ASSISTANT_CONVERSATION 音频模式的 Google 助理应用可以进一步提高音量控制的一致性。Google 助理应用可以使用此模式向系统提供有关活跃 Google 助理会话的提示，确保可以在活跃 USAGE_ASSISTANT 播放之外或使用连接的蓝牙外设控制 Google 助理流。

हैंडऑफ़

हैंडऑफ़, Android 17 में उपलब्ध होने वाली एक नई सुविधा और एपीआई है. ऐप्लिकेशन डेवलपर इसे इंटिग्रेट कर सकते हैं, ताकि वे अपने उपयोगकर्ताओं को क्रॉस-डिवाइस पर एक जैसा अनुभव दे सकें. इस कुकी की मदद से, उपयोगकर्ता किसी Android डिवाइस पर ऐप्लिकेशन का इस्तेमाल शुरू कर सकता है और उसे किसी दूसरे Android डिवाइस पर जारी रख सकता है. हैंडऑफ़, उपयोगकर्ता के डिवाइस के बैकग्राउंड में काम करता है. साथ ही, उपयोगकर्ता के आस-पास मौजूद अन्य डिवाइसों पर उपलब्ध गतिविधियों को दिखाता है. ये गतिविधियां, पाने वाले डिवाइस पर अलग-अलग एंट्री पॉइंट के ज़रिए दिखती हैं. जैसे, लॉन्चर और टास्कबार.

अगर Android का नेटिव ऐप्लिकेशन, डेटा पाने वाले डिवाइस पर इंस्टॉल है और उपलब्ध है, तो ऐप्लिकेशन उसे लॉन्च करने के लिए हैंडऑफ़ की सुविधा का इस्तेमाल कर सकते हैं. ऐप्लिकेशन-टू-ऐप्लिकेशन फ़्लो में, उपयोगकर्ता को तय की गई गतिविधि से डीप लिंक किया जाता है. इसके अलावा, ऐप्लिकेशन से वेब पर रीडायरेक्ट करने की सुविधा को फ़ॉलबैक विकल्प के तौर पर उपलब्ध कराया जा सकता है. इसे यूआरएल रीडायरेक्ट करने की सुविधा के साथ सीधे तौर पर लागू किया जा सकता है.

हैंडऑफ़ की सुविधा, हर गतिविधि के हिसाब से लागू की जाती है. हैंडऑफ़ की सुविधा चालू करने के लिए, गतिविधि के लिए setHandoffEnabled() तरीके का इस्तेमाल करें. हैंडऑफ़ के साथ-साथ, कुछ और डेटा भी पास करना पड़ सकता है, ताकि डेटा पाने वाले डिवाइस पर फिर से बनाई गई गतिविधि, सही स्थिति को वापस ला सके. onHandoffActivityDataRequested() कॉलबैक को लागू करें, ताकि HandoffActivityData ऑब्जेक्ट को वापस किया जा सके. इस ऑब्जेक्ट में ऐसी जानकारी होती है जिससे यह पता चलता है कि Handoff को, डेटा पाने वाले डिवाइस पर गतिविधि को कैसे हैंडल करना चाहिए और उसे फिर से कैसे बनाना चाहिए.

लाइव अपडेट - सिमैंटिक कलर एपीआई

在 Android 17 中，实时更新启动了语义着色 API，以支持具有通用含义的颜色。

以下类支持语义着色：

填色游戏

绿色：与安全相关。此颜色应在以下情况下使用：让别人知道您处于安全状态。
橙色：用于表示警告和标记物理危险。在用户需要注意以设置更好的保护设置的情况下，应使用此颜色。
红色：通常表示危险、停止。它应在需要人们紧急关注的情况下显示。
蓝色：中性颜色，适用于信息性内容，应与其他内容区分开来。

以下示例展示了如何将语义样式应用于通知中的文本：

  val ssb = SpannableStringBuilder()
        .append("Colors: ")
        .append("NONE", Notification.createSemanticStyleAnnotation(SEMANTIC_STYLE_UNSPECIFIED), 0)
        .append(", ")
        .append("INFO", Notification.createSemanticStyleAnnotation(SEMANTIC_STYLE_INFO), 0)
        .append(", ")
        .append("SAFE", Notification.createSemanticStyleAnnotation(SEMANTIC_STYLE_SAFE), 0)
        .append(", ")
        .append("CAUTION", Notification.createSemanticStyleAnnotation(SEMANTIC_STYLE_CAUTION), 0)
        .append(", ")
        .append("DANGER", Notification.createSemanticStyleAnnotation(SEMANTIC_STYLE_DANGER), 0)

    Notification.Builder(context, channelId)
          .setSmallIcon(R.drawable.ic_icon)
          .setContentTitle("Hello World!")
          .setContentText(ssb)
          .setOngoing(true)
              .setRequestPromotedOngoing(true)

Android 17 के लिए UWB Downlink-TDoA API

डाउनलिंक टाइम डिफ़रेंस ऑफ़ अराइवल (डीएल-टीडीओए) रेंजिंग की मदद से, कोई डिवाइस सिग्नल के पहुंचने के समय की तुलना करके, कई ऐंकर के मुकाबले अपनी जगह की जानकारी का पता लगा सकता है.

यहां दिए गए स्निपेट से पता चलता है कि रेंजिंग मैनेजर को कैसे शुरू किया जाता है, डिवाइस की क्षमताओं की पुष्टि कैसे की जाती है, और डीएल-टीडीओए सेशन कैसे शुरू किया जाता है:

Kotlin

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 != null && capabilities.uwbCapabilities!!.isDlTdoaSupported) {
                    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
    }
}

Java

public class RangingApp {

    public void initDlTdoa(Context context) {

        // Initialize the Ranging Manager
        RangingManager rangingManager = context.getSystemService(RangingManager.class);

        // Register for device capabilities
        RangingManager.CapabilitiesCallback capabilitiesCallback = new RangingManager.RangingCapabilitiesCallback() {
            @Override
            public void onRangingCapabilities(RangingCapabilities capabilities) {
                // Make sure Dl-TDoA is supported before starting the session
                if (capabilities.getUwbCapabilities() != null && capabilities.getUwbCapabilities().isDlTdoaSupported()) {
                    startDlTDoASession(context);
                }
            }
        };
        rangingManager.registerCapabilitiesCallback(Executors.newSingleThreadExecutor(), capabilitiesCallback);
    }

    public void startDlTDoASession(Context context) {
        RangingManager rangingManager = context.getSystemService(RangingManager.class);

        // Create session and configure parameters
        Executor executor = Executors.newSingleThreadExecutor();
        RangingSession rangingSession = rangingManager.createRangingSession(executor, new RangingSessionCallback());
        byte[] rangingRoundIndexes = new byte[] {0};
        byte[] config = new byte[0]; // OOB config data
        DlTdoaRangingParams params = DlTdoaRangingParams.createFromFiraConfigPacket(config, rangingRoundIndexes);

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

        RawDtTagRangingConfig dtTagConfig = new RawDtTagRangingConfig.Builder(rawTagDevice).build();

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

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

    private static class RangingSessionCallback implements RangingSession.Callback {

        @Override
        public void onDlTdoaResults(RangingDevice peer, DlTdoaMeasurement measurement) {
            // Process measurement results here
        }
    }
}

आउट-ऑफ़-बैंड (ओओबी) कॉन्फ़िगरेशन

यहां दिए गए स्निपेट में, वाई-फ़ाई और बीएलई के लिए डीएल-टीडीओए ओओबी कॉन्फ़िगरेशन डेटा का एक उदाहरण दिया गया है:

Java

// Wifi Configuration
byte[] wifiConfig = {
    (byte) 0xDD, (byte) 0x2D, (byte) 0x5A, (byte) 0x18, (byte) 0xFF, // Header
    (byte) 0x5F, (byte) 0x19, // FiRa Sub-Element
    (byte) 0x02, (byte) 0x00, // Profile ID
    (byte) 0x06, (byte) 0x02, (byte) 0x20, (byte) 0x08, // MAC Address
    (byte) 0x14, (byte) 0x01, (byte) 0x0C, // Preamble Index
    (byte) 0x27, (byte) 0x02, (byte) 0x08, (byte) 0x07, // Vendor ID
    (byte) 0x28, (byte) 0x06, (byte) 0xCA, (byte) 0xC8, (byte) 0xA6, (byte) 0xF7, (byte) 0x6F, (byte) 0x08, // Static STS IV
    (byte) 0x08, (byte) 0x02, (byte) 0x60, (byte) 0x09, // Slot Duration
    (byte) 0x1B, (byte) 0x01, (byte) 0x0A, // Slots per RR
    (byte) 0x09, (byte) 0x04, (byte) 0xE8, (byte) 0x03, (byte) 0x00, (byte) 0x00, // Duration
    (byte) 0x9F, (byte) 0x04, (byte) 0x67, (byte) 0x45, (byte) 0x23, (byte) 0x01  // Session ID
};

// BLE Configuration
byte[] bleConfig = {
    (byte) 0x2D, (byte) 0x16, (byte) 0xF4, (byte) 0xFF, // Header
    (byte) 0x5F, (byte) 0x19, // FiRa Sub-Element
    (byte) 0x02, (byte) 0x00, // Profile ID
    (byte) 0x06, (byte) 0x02, (byte) 0x20, (byte) 0x08, // MAC Address
    (byte) 0x14, (byte) 0x01, (byte) 0x0C, // Preamble Index
    (byte) 0x27, (byte) 0x02, (byte) 0x08, (byte) 0x07, // Vendor ID
    (byte) 0x28, (byte) 0x06, (byte) 0xCA, (byte) 0xC8, (byte) 0xA6, (byte) 0xF7, (byte) 0x6F, (byte) 0x08, // Static STS IV
    (byte) 0x08, (byte) 0x02, (byte) 0x60, (byte) 0x09, // Slot Duration
    (byte) 0x1B, (byte) 0x01, (byte) 0x0A, // Slots per RR
    (byte) 0x09, (byte) 0x04, (byte) 0xE8, (byte) 0x03, (byte) 0x00, (byte) 0x00, // Duration
    (byte) 0x9F, (byte) 0x04, (byte) 0x67, (byte) 0x45, (byte) 0x23, (byte) 0x01  // Session ID
};

अगर ओओबी कॉन्फ़िगरेशन मौजूद न होने की वजह से, उसका इस्तेमाल नहीं किया जा सकता या आपको डिफ़ॉल्ट वैल्यू बदलनी हैं, जो ओओबी कॉन्फ़िगरेशन में मौजूद नहीं हैं, तो यहां दिए गए स्निपेट में दिखाए गए तरीके से, DlTdoaRangingParams.Builder की मदद से पैरामीटर बनाए जा सकते हैं. DlTdoaRangingParams.createFromFiraConfigPacket() के बजाय, इन पैरामीटर का इस्तेमाल किया जा सकता है:

Kotlin

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()

Java

DlTdoaRangingParams dlTdoaParams = new DlTdoaRangingParams.Builder(1)
    .setComplexChannel(new UwbComplexChannel.Builder()
            .setChannel(9).setPreambleIndex(10).build())
    .setDeviceAddress(deviceAddress)
    .setSessionKeyInfo(new byte[]{0x01, 0x02, 0x03, 0x04})
    .setRangingIntervalMillis(240)
    .setSlotDuration(UwbRangingParams.DURATION_2_MS)
    .setSlotsPerRangingRound(20)
    .setRangingRoundIndexes(new byte[]{0x01, 0x05})
    .build();