اولین درس این کلاس، استفاده از کشف سرویس شبکه ، به شما نشان داد که چگونه سرویسهایی را که به یک شبکه محلی متصل هستند، کشف کنید. با این حال، استفاده از کشف سرویس Wi-Fi Direct (P2P) به شما این امکان را میدهد که سرویسهای دستگاههای مجاور را مستقیماً و بدون اتصال به شبکه کشف کنید. همچنین میتوانید سرویسهای در حال اجرا روی دستگاه خود را تبلیغ کنید. این قابلیتها به شما کمک میکنند تا بین برنامهها ارتباط برقرار کنید، حتی زمانی که هیچ شبکه محلی یا هاتاسپاتی در دسترس نیست.
اگرچه این مجموعه APIها از نظر هدف مشابه APIهای کشف سرویس شبکه هستند که در درس قبلی توضیح داده شد، اما پیادهسازی آنها در کد بسیار متفاوت است. این درس به شما نشان میدهد که چگونه با استفاده از Wi-Fi Direct، سرویسهای موجود در دستگاههای دیگر را کشف کنید. این درس فرض میکند که شما از قبل با API Wi-Fi Direct آشنا هستید.
مانیفست را تنظیم کنید
برای استفاده از Wi-Fi P2P، مجوزهای CHANGE_WIFI_STATE ، ACCESS_WIFI_STATE ، ACCESS_FINE_LOCATION و INTERNET را به مانیفست خود اضافه کنید. اگر برنامه شما اندروید ۱۳ (سطح API ۳۳) یا بالاتر را هدف قرار میدهد، مجوز NEARBY_WIFI_DEVICES را نیز به مانیفست خود اضافه کنید. اگرچه Wi-Fi Direct به اتصال اینترنت نیاز ندارد، اما از سوکتهای استاندارد جاوا استفاده میکند و استفاده از آنها در اندروید نیاز به مجوزهای درخواستی دارد.
<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.example.android.nsdchat" ... <uses-permission android:required="true" android:name="android.permission.ACCESS_WIFI_STATE"/> <uses-permission android:required="true" android:name="android.permission.CHANGE_WIFI_STATE"/> <uses-permission android:required="true" android:name="android.permission.INTERNET"/> <!-- If your app targets Android 13 (API level 33) or higher, you must declare the NEARBY_WIFI_DEVICES permission. --> <uses-permission android:name="android.permission.NEARBY_WIFI_DEVICES" <!-- If your app derives location information from Wi-Fi APIs, don't include the "usesPermissionFlags" attribute. --> android:usesPermissionFlags="neverForLocation" /> <uses-permission android:required="true" android:name="android.permission.ACCESS_FINE_LOCATION" <!-- If any feature in your app relies on precise location information, don't include the "maxSdkVersion" attribute. --> android:maxSdkVersion="32" /> ...
علاوه بر مجوزهای قبلی، API های زیر نیز نیاز به فعال بودن حالت موقعیت مکانی دارند:
اضافه کردن سرویس محلی
اگر یک سرویس محلی ارائه میدهید، باید آن را برای کشف سرویس ثبت کنید. پس از ثبت سرویس محلی شما، چارچوب به طور خودکار به درخواستهای کشف سرویس از طرف همتاها پاسخ میدهد.
برای ایجاد یک سرویس محلی:
- یک شیء
WifiP2pServiceInfoایجاد کنید. - آن را با اطلاعات مربوط به خدمات خود پر کنید.
- برای ثبت سرویس محلی جهت کشف سرویس،
addLocalService()را فراخوانی کنید.
کاتلین
private fun startRegistration() { // Create a string map containing information about your service. val record: Map<String, String> = mapOf( "listenport" to SERVER_PORT.toString(), "buddyname" to "John Doe${(Math.random() * 1000).toInt()}", "available" to "visible" ) // Service information. Pass it an instance name, service type // _protocol._transportlayer , and the map containing // information other devices will want once they connect to this one. val serviceInfo = WifiP2pDnsSdServiceInfo.newInstance("_test", "_presence._tcp", record) // Add the local service, sending the service info, network channel, // and listener that will be used to indicate success or failure of // the request. manager.addLocalService(channel, serviceInfo, object : WifiP2pManager.ActionListener { override fun onSuccess() { // Command successful! Code isn't necessarily needed here, // Unless you want to update the UI or add logging statements. } override fun onFailure(arg0: Int) { // Command failed. Check for P2P_UNSUPPORTED, ERROR, or BUSY } }) }
جاوا
private void startRegistration() { // Create a string map containing information about your service. Map record = new HashMap(); record.put("listenport", String.valueOf(SERVER_PORT)); record.put("buddyname", "John Doe" + (int) (Math.random() * 1000)); record.put("available", "visible"); // Service information. Pass it an instance name, service type // _protocol._transportlayer , and the map containing // information other devices will want once they connect to this one. WifiP2pDnsSdServiceInfo serviceInfo = WifiP2pDnsSdServiceInfo.newInstance("_test", "_presence._tcp", record); // Add the local service, sending the service info, network channel, // and listener that will be used to indicate success or failure of // the request. manager.addLocalService(channel, serviceInfo, new ActionListener() { @Override public void onSuccess() { // Command successful! Code isn't necessarily needed here, // Unless you want to update the UI or add logging statements. } @Override public void onFailure(int arg0) { // Command failed. Check for P2P_UNSUPPORTED, ERROR, or BUSY } }); }
سرویسهای نزدیک را کشف کنید
اندروید از متدهای فراخوانی برای اطلاعرسانی به برنامه شما در مورد سرویسهای موجود استفاده میکند، بنابراین اولین کاری که باید انجام دهید تنظیم آنها است. یک WifiP2pManager.DnsSdTxtRecordListener ایجاد کنید تا به رکوردهای ورودی گوش دهد. این رکورد میتواند به صورت اختیاری توسط دستگاههای دیگر پخش شود. وقتی دستگاهی وارد میشود، آدرس دستگاه و هر اطلاعات مرتبط دیگری را که میخواهید در یک ساختار داده خارج از متد فعلی کپی کنید تا بعداً بتوانید به آن دسترسی داشته باشید. مثال زیر فرض میکند که رکورد شامل یک فیلد "buddyname" است که با هویت کاربر پر شده است.
کاتلین
private val buddies = mutableMapOf<String, String>() ... private fun discoverService() { /* Callback includes: * fullDomain: full domain name: e.g. "printer._ipp._tcp.local." * record: TXT record dta as a map of key/value pairs. * device: The device running the advertised service. */ val txtListener = DnsSdTxtRecordListener { fullDomain, record, device -> Log.d(TAG, "DnsSdTxtRecord available -$record") record["buddyname"]?.also { buddies[device.deviceAddress] = it } } }
جاوا
final HashMap<String, String> buddies = new HashMap<String, String>(); ... private void discoverService() { DnsSdTxtRecordListener txtListener = new DnsSdTxtRecordListener() { @Override /* Callback includes: * fullDomain: full domain name: e.g. "printer._ipp._tcp.local." * record: TXT record dta as a map of key/value pairs. * device: The device running the advertised service. */ public void onDnsSdTxtRecordAvailable( String fullDomain, Map record, WifiP2pDevice device) { Log.d(TAG, "DnsSdTxtRecord available -" + record.toString()); buddies.put(device.deviceAddress, record.get("buddyname")); } }; }
برای دریافت اطلاعات سرویس، یک WifiP2pManager.DnsSdServiceResponseListener ایجاد کنید. این کلاس توضیحات واقعی و اطلاعات اتصال را دریافت میکند. قطعه کد قبلی یک شیء Map برای جفت کردن آدرس دستگاه با نام buddy پیادهسازی کرده است. شنونده پاسخ سرویس از این برای پیوند دادن رکورد DNS با اطلاعات سرویس مربوطه استفاده میکند. پس از پیادهسازی هر دو شنونده، آنها را با استفاده از متد setDnsSdResponseListeners() به WifiP2pManager اضافه کنید.
کاتلین
private fun discoverService() { ... val servListener = DnsSdServiceResponseListener { instanceName, registrationType, resourceType -> // Update the device name with the human-friendly version from // the DnsTxtRecord, assuming one arrived. resourceType.deviceName = buddies[resourceType.deviceAddress] ?: resourceType.deviceName // Add to the custom adapter defined specifically for showing // wifi devices. val fragment = fragmentManager .findFragmentById(R.id.frag_peerlist) as WiFiDirectServicesList (fragment.listAdapter as WiFiDevicesAdapter).apply { add(resourceType) notifyDataSetChanged() } Log.d(TAG, "onBonjourServiceAvailable $instanceName") } manager.setDnsSdResponseListeners(channel, servListener, txtListener) ... }
جاوا
private void discoverService() { ... DnsSdServiceResponseListener servListener = new DnsSdServiceResponseListener() { @Override public void onDnsSdServiceAvailable(String instanceName, String registrationType, WifiP2pDevice resourceType) { // Update the device name with the human-friendly version from // the DnsTxtRecord, assuming one arrived. resourceType.deviceName = buddies .containsKey(resourceType.deviceAddress) ? buddies .get(resourceType.deviceAddress) : resourceType.deviceName; // Add to the custom adapter defined specifically for showing // wifi devices. WiFiDirectServicesList fragment = (WiFiDirectServicesList) getFragmentManager() .findFragmentById(R.id.frag_peerlist); WiFiDevicesAdapter adapter = ((WiFiDevicesAdapter) fragment .getListAdapter()); adapter.add(resourceType); adapter.notifyDataSetChanged(); Log.d(TAG, "onBonjourServiceAvailable " + instanceName); } }; manager.setDnsSdResponseListeners(channel, servListener, txtListener); ... }
حالا یک درخواست سرویس ایجاد کنید و addServiceRequest() را فراخوانی کنید. این متد همچنین یک شنونده (listener) برای گزارش موفقیت یا شکست میگیرد.
کاتلین
serviceRequest = WifiP2pDnsSdServiceRequest.newInstance() manager.addServiceRequest( channel, serviceRequest, object : WifiP2pManager.ActionListener { override fun onSuccess() { // Success! } override fun onFailure(code: Int) { // Command failed. Check for P2P_UNSUPPORTED, ERROR, or BUSY } } )
جاوا
serviceRequest = WifiP2pDnsSdServiceRequest.newInstance(); manager.addServiceRequest(channel, serviceRequest, new ActionListener() { @Override public void onSuccess() { // Success! } @Override public void onFailure(int code) { // Command failed. Check for P2P_UNSUPPORTED, ERROR, or BUSY } });
در نهایت، تابع discoverServices() را فراخوانی کنید.
کاتلین
manager.discoverServices( channel, object : WifiP2pManager.ActionListener { override fun onSuccess() { // Success! } override fun onFailure(code: Int) { // Command failed. Check for P2P_UNSUPPORTED, ERROR, or BUSY when (code) { WifiP2pManager.P2P_UNSUPPORTED -> { Log.d(TAG, "Wi-Fi Direct isn't supported on this device.") } } } } )
جاوا
manager.discoverServices(channel, new ActionListener() { @Override public void onSuccess() { // Success! } @Override public void onFailure(int code) { // Command failed. Check for P2P_UNSUPPORTED, ERROR, or BUSY if (code == WifiP2pManager.P2P_UNSUPPORTED) { Log.d(TAG, "Wi-Fi Direct isn't supported on this device."); else if(...) ... } });
اگر همه چیز خوب پیش برود، هورا، کار تمام است! اگر با مشکلی مواجه شدید، به یاد داشته باشید که فراخوانیهای ناهمزمانی که انجام دادهاید، یک WifiP2pManager.ActionListener را به عنوان آرگومان دریافت میکنند و این به شما callbackهایی میدهد که موفقیت یا شکست را نشان میدهند. برای تشخیص مشکلات، کد اشکالزدایی را در onFailure() قرار دهید. کد خطای ارائه شده توسط این روش، مشکل را نشان میدهد. در اینجا مقادیر خطای احتمالی و معنای آنها آمده است.
-
P2P_UNSUPPORTED - وایفای دایرکت در دستگاهی که این برنامه روی آن اجرا میشود، پشتیبانی نمیشود.
-
BUSY - سیستم برای پردازش درخواست خیلی شلوغ است.
-
ERROR - این عملیات به دلیل خطای داخلی انجام نشد.