Added in [API level 35](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  
Also in [T Extensions 12](https://developer.android.com/sdkExtensions) Summary: [Nested Classes](https://developer.android.com/reference/android/net/nsd/DiscoveryRequest#nestedclasses) \| [Constants](https://developer.android.com/reference/android/net/nsd/DiscoveryRequest#constants) \| [Inherited Constants](https://developer.android.com/reference/android/net/nsd/DiscoveryRequest#inhconstants) \| [Fields](https://developer.android.com/reference/android/net/nsd/DiscoveryRequest#lfields) \| [Methods](https://developer.android.com/reference/android/net/nsd/DiscoveryRequest#pubmethods) \| [Inherited Methods](https://developer.android.com/reference/android/net/nsd/DiscoveryRequest#inhmethods)

# DiscoveryRequest

*** ** * ** ***


`
public

final

class
DiscoveryRequest
`


`

extends https://developer.android.com/reference/java/lang/Object


`

`


implements

https://developer.android.com/reference/android/os/Parcelable


`

|---|---|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object) ||
| ↳ | android.net.nsd.DiscoveryRequest |

<br />

*** ** * ** ***

Encapsulates parameters for `https://developer.android.com/reference/android/net/nsd/NsdManager#discoverServices(android.net.nsd.DiscoveryRequest,%20java.util.concurrent.Executor,%20android.net.nsd.NsdManager.DiscoveryListener)`.

## Summary

| ### Nested classes ||
|---|---|
| ` class` | `https://developer.android.com/reference/android/net/nsd/DiscoveryRequest.Builder` The builder for creating new `https://developer.android.com/reference/android/net/nsd/DiscoveryRequest` objects. |

| ### Constants ||
|---|---|
| `long` | `https://developer.android.com/reference/android/net/nsd/DiscoveryRequest#FLAG_NO_PICKER` Indicates that a UI service picker should never be shown to the user for this request. |
| `long` | `https://developer.android.com/reference/android/net/nsd/DiscoveryRequest#FLAG_SHOW_PICKER` Indicates that a UI service picker must be shown to the user for this request. |
| `long` | `https://developer.android.com/reference/android/net/nsd/DiscoveryRequest#FLAG_USER_APPROVED_ONLY` Indicates that only services previously approved by the user must be discovered. |

| ### Inherited constants |
|---|
| From interface `https://developer.android.com/reference/android/os/Parcelable` |---|---| | `int` | `https://developer.android.com/reference/android/os/Parcelable#CONTENTS_FILE_DESCRIPTOR` Descriptor bit used with `https://developer.android.com/reference/android/os/Parcelable#describeContents()`: indicates that the Parcelable object's flattened representation includes a file descriptor. | | `int` | `https://developer.android.com/reference/android/os/Parcelable#PARCELABLE_WRITE_RETURN_VALUE` Flag for use with `https://developer.android.com/reference/android/os/Parcelable#writeToParcel(android.os.Parcel,%20int)`: the object being written is a return value, that is the result of a function such as "`Parcelable someFunction()`", "`void someFunction(out Parcelable)`", or "`void someFunction(inout Parcelable)`". | |

| ### Fields ||
|---|---|
| ` public static final https://developer.android.com/reference/android/os/Parcelable.Creator<https://developer.android.com/reference/android/net/nsd/DiscoveryRequest>` | `https://developer.android.com/reference/android/net/nsd/DiscoveryRequest#CREATOR` |

| ### Public methods ||
|---|---|
| ` int` | ` https://developer.android.com/reference/android/net/nsd/DiscoveryRequest#describeContents()() ` Describe the kinds of special objects contained in this Parcelable instance's marshaled representation. |
| ` boolean` | ` https://developer.android.com/reference/android/net/nsd/DiscoveryRequest#equals(java.lang.Object)(https://developer.android.com/reference/java/lang/Object other) ` Indicates whether some other object is "equal to" this one. |
| ` https://developer.android.com/reference/java/util/Map<https://developer.android.com/reference/java/lang/String, https://developer.android.com/reference/android/os/PatternMatcher>` | ` https://developer.android.com/reference/android/net/nsd/DiscoveryRequest#getAttributeFilters()() ` Returns the filters to apply to attributes as per `https://developer.android.com/reference/android/net/nsd/NsdServiceInfo#getAttributes()`. |
| ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/android/net/nsd/DiscoveryRequest#getDisplayNameAttribute()() ` Return the attribute to use to display the service in system UI service picker. |
| ` long` | ` https://developer.android.com/reference/android/net/nsd/DiscoveryRequest#getFlags()() ` Returns the discovery flags. |
| ` https://developer.android.com/reference/android/net/Network` | ` https://developer.android.com/reference/android/net/nsd/DiscoveryRequest#getNetwork()() ` Returns the `https://developer.android.com/reference/android/net/Network` on which the query should be sent or `null` if no network is specified. |
| ` https://developer.android.com/reference/android/os/PatternMatcher` | ` https://developer.android.com/reference/android/net/nsd/DiscoveryRequest#getServiceNameFilter()() ` Returns the filter to apply to service names as per `https://developer.android.com/reference/android/net/nsd/NsdServiceInfo#getServiceName()`. |
| ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/android/net/nsd/DiscoveryRequest#getServiceType()() ` Returns the service type in format of dot-joint string of two labels. |
| ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/android/net/nsd/DiscoveryRequest#getSubtype()() ` Returns the subtype without the trailing "._sub" label or `null` if no subtype is specified. |
| ` int` | ` https://developer.android.com/reference/android/net/nsd/DiscoveryRequest#hashCode()() ` Returns a hash code value for the object. |
| ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/android/net/nsd/DiscoveryRequest#toString()() ` Returns a string representation of the object. |
| ` void` | ` https://developer.android.com/reference/android/net/nsd/DiscoveryRequest#writeToParcel(android.os.Parcel,%20int)(https://developer.android.com/reference/android/os/Parcel dest, int flags) ` Flatten this object in to a Parcel. |

| ### Inherited methods |
|---|---|
| From class ` https://developer.android.com/reference/java/lang/Object ` |---|---| | ` https://developer.android.com/reference/java/lang/Object` | ` https://developer.android.com/reference/java/lang/Object#clone()() ` Creates and returns a copy of this object. | | ` boolean` | ` https://developer.android.com/reference/java/lang/Object#equals(java.lang.Object)(https://developer.android.com/reference/java/lang/Object obj) ` Indicates whether some other object is "equal to" this one. | | ` void` | ` https://developer.android.com/reference/java/lang/Object#finalize()() ` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. | | ` final https://developer.android.com/reference/java/lang/Class<?>` | ` https://developer.android.com/reference/java/lang/Object#getClass()() ` Returns the runtime class of this `Object`. | | ` int` | ` https://developer.android.com/reference/java/lang/Object#hashCode()() ` Returns a hash code value for the object. | | ` final void` | ` https://developer.android.com/reference/java/lang/Object#notify()() ` Wakes up a single thread that is waiting on this object's monitor. | | ` final void` | ` https://developer.android.com/reference/java/lang/Object#notifyAll()() ` Wakes up all threads that are waiting on this object's monitor. | | ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/java/lang/Object#toString()() ` Returns a string representation of the object. | | ` final void` | ` https://developer.android.com/reference/java/lang/Object#wait(long,%20int)(long timeoutMillis, int nanos) ` Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*, or until a certain amount of real time has elapsed. | | ` final void` | ` https://developer.android.com/reference/java/lang/Object#wait(long)(long timeoutMillis) ` Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*, or until a certain amount of real time has elapsed. | | ` final void` | ` https://developer.android.com/reference/java/lang/Object#wait()() ` Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*. | ||
| From interface ` https://developer.android.com/reference/android/os/Parcelable ` |---|---| | ` abstract int` | ` https://developer.android.com/reference/android/os/Parcelable#describeContents()() ` Describe the kinds of special objects contained in this Parcelable instance's marshaled representation. | | ` abstract void` | ` https://developer.android.com/reference/android/os/Parcelable#writeToParcel(android.os.Parcel,%20int)(https://developer.android.com/reference/android/os/Parcel dest, int flags) ` Flatten this object in to a Parcel. | ||

## Constants

### FLAG_NO_PICKER

Added in [API level 37](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  
Also in [T Extensions 22](https://developer.android.com/sdkExtensions)

```
public static final long FLAG_NO_PICKER
```

Indicates that a UI service picker should never be shown to the user for this request.

Starting from target SDK `https://developer.android.com/reference/android/os/Build.VERSION_CODES#CINNAMON_BUN`, if the
caller does not have the `https://developer.android.com/reference/android/Manifest.permission#ACCESS_LOCAL_NETWORK`
permission and does not specify `https://developer.android.com/reference/android/net/nsd/DiscoveryRequest#FLAG_USER_APPROVED_ONLY`, this will cause the request
to fail with
`https://developer.android.com/reference/android/net/nsd/NsdManager.DiscoveryListener#onStartDiscoveryFailed(java.lang.String,%20int)` and
`https://developer.android.com/reference/android/net/nsd/NsdManager#FAILURE_PERMISSION_DENIED`.

If neither `https://developer.android.com/reference/android/net/nsd/DiscoveryRequest#FLAG_NO_PICKER` nor `https://developer.android.com/reference/android/net/nsd/DiscoveryRequest#FLAG_SHOW_PICKER` is set, the picker will
be shown if the app does not have `https://developer.android.com/reference/android/Manifest.permission#ACCESS_LOCAL_NETWORK`
permission.


Value is either `0` or a combination of the following:

- `https://developer.android.com/reference/android/net/nsd/DiscoveryRequest#FLAG_NO_PICKER`
- `https://developer.android.com/reference/android/net/nsd/DiscoveryRequest#FLAG_SHOW_PICKER`
- `https://developer.android.com/reference/android/net/nsd/DiscoveryRequest#FLAG_USER_APPROVED_ONLY`
  - Constant Value: 1 (0x0000000000000001)

### FLAG_SHOW_PICKER

Added in [API level 37](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  
Also in [T Extensions 22](https://developer.android.com/sdkExtensions)

```
public static final long FLAG_SHOW_PICKER
```

Indicates that a UI service picker must be shown to the user for this request.

If this flag is set, the user will be prompted to choose a service to be discovered among
all services matching the discovery service type and discovery filters.
`https://developer.android.com/reference/android/net/nsd/NsdManager.DiscoveryListener#onServiceFound(android.net.nsd.NsdServiceInfo)` will be
called at most once, and discovery will stop if a service is selected or the user cancels
the request. `https://developer.android.com/reference/android/Manifest.permission#ACCESS_LOCAL_NETWORK` permission is \*not\*
necessary when discovering with this flag.

Once a service has been selected by the user in the UI picker,
`https://developer.android.com/reference/android/net/nsd/NsdManager#resolveService(android.net.nsd.NsdServiceInfo,%20java.util.concurrent.Executor,%20android.net.nsd.NsdManager.ResolveListener)` or `https://developer.android.com/reference/android/net/nsd/NsdManager#registerServiceInfoCallback(android.net.nsd.NsdServiceInfo,%20java.util.concurrent.Executor,%20android.net.nsd.NsdManager.ServiceInfoCallback)` can be called for that service without requiring
the `https://developer.android.com/reference/android/Manifest.permission#ACCESS_LOCAL_NETWORK` permission or any further UI
being displayed.

If neither `https://developer.android.com/reference/android/net/nsd/DiscoveryRequest#FLAG_NO_PICKER` nor `https://developer.android.com/reference/android/net/nsd/DiscoveryRequest#FLAG_SHOW_PICKER` is set, the picker will
be shown if the app does not have `https://developer.android.com/reference/android/Manifest.permission#ACCESS_LOCAL_NETWORK`
permission.

This flag cannot be combined with `https://developer.android.com/reference/android/net/nsd/DiscoveryRequest#FLAG_NO_PICKER` or
`https://developer.android.com/reference/android/net/nsd/DiscoveryRequest#FLAG_USER_APPROVED_ONLY`.


Value is either `0` or a combination of the following:

- `https://developer.android.com/reference/android/net/nsd/DiscoveryRequest#FLAG_NO_PICKER`
- `https://developer.android.com/reference/android/net/nsd/DiscoveryRequest#FLAG_SHOW_PICKER`
- `https://developer.android.com/reference/android/net/nsd/DiscoveryRequest#FLAG_USER_APPROVED_ONLY`
  - Constant Value: 2 (0x0000000000000002)

### FLAG_USER_APPROVED_ONLY

Added in [API level 37](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  
Also in [T Extensions 22](https://developer.android.com/sdkExtensions)

```
public static final long FLAG_USER_APPROVED_ONLY
```

Indicates that only services previously approved by the user must be discovered.

If this flag is set, only services that have been selected by the user in previous
requests that used the service picker UI will be discovered.
`https://developer.android.com/reference/android/Manifest.permission#ACCESS_LOCAL_NETWORK` permission is \*not\* necessary when
discovering with this flag.

This flag implies `https://developer.android.com/reference/android/net/nsd/DiscoveryRequest#FLAG_NO_PICKER`, and it cannot be combined with
`https://developer.android.com/reference/android/net/nsd/DiscoveryRequest#FLAG_SHOW_PICKER`.


Value is either `0` or a combination of the following:

- `https://developer.android.com/reference/android/net/nsd/DiscoveryRequest#FLAG_NO_PICKER`
- `https://developer.android.com/reference/android/net/nsd/DiscoveryRequest#FLAG_SHOW_PICKER`
- `https://developer.android.com/reference/android/net/nsd/DiscoveryRequest#FLAG_USER_APPROVED_ONLY`
**See also:**

  - `https://developer.android.com/reference/android/net/nsd/DiscoveryRequest#FLAG_SHOW_PICKER`
  - Constant Value: 4 (0x0000000000000004)

## Fields

### CREATOR

Added in [API level 35](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  
Also in [T Extensions 12](https://developer.android.com/sdkExtensions)

```
public static final Creator<DiscoveryRequest> CREATOR
```

<br />

<br />

## Public methods

### describeContents

Added in [API level 35](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public int describeContents ()
```

Describe the kinds of special objects contained in this Parcelable
instance's marshaled representation. For example, if the object will
include a file descriptor in the output of `https://developer.android.com/reference/android/os/Parcelable#writeToParcel(android.os.Parcel,%20int)`,
the return value of this method must include the
`https://developer.android.com/reference/android/os/Parcelable#CONTENTS_FILE_DESCRIPTOR` bit.

<br />

| Returns ||
|---|---|
| `int` | a bitmask indicating the set of special object types marshaled by this Parcelable object instance. Value is either `0` or - `https://developer.android.com/reference/android/os/Parcelable#CONTENTS_FILE_DESCRIPTOR` |

### equals

Added in [API level 35](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public boolean equals (Object other)
```

Indicates whether some other object is "equal to" this one.


The `equals` method implements an equivalence relation
on non-null object references:

- It is *reflexive*: for any non-null reference value `x`, `x.equals(x)` should return `true`.
- It is *symmetric*: for any non-null reference values `x` and `y`, `x.equals(y)` should return `true` if and only if `y.equals(x)` returns `true`.
- It is *transitive*: for any non-null reference values `x`, `y`, and `z`, if `x.equals(y)` returns `true` and `y.equals(z)` returns `true`, then `x.equals(z)` should return `true`.
- It is *consistent*: for any non-null reference values `x` and `y`, multiple invocations of `x.equals(y)` consistently return `true` or consistently return `false`, provided no information used in `equals` comparisons on the objects is modified.
- For any non-null reference value `x`, `x.equals(null)` should return `false`.


An equivalence relation partitions the elements it operates on
into *equivalence classes*; all the members of an
equivalence class are equal to each other. Members of an
equivalence class are substitutable for each other, at least
for some purposes.

<br />

| Parameters ||
|---|---|
| `other` | `Object`: the reference object with which to compare. <br /> |

| Returns ||
|---|---|
| `boolean` | `true` if this object is the same as the obj argument; `false` otherwise. <br /> |

### getAttributeFilters

Added in [API level 37](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  
Also in [T Extensions 22](https://developer.android.com/sdkExtensions)

```
public Map<String, PatternMatcher> getAttributeFilters ()
```

Returns the filters to apply to attributes as per `https://developer.android.com/reference/android/net/nsd/NsdServiceInfo#getAttributes()`.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/java/util/Map<https://developer.android.com/reference/java/lang/String, https://developer.android.com/reference/android/os/PatternMatcher>` | This value cannot be `null`. <br /> |

### getDisplayNameAttribute

Added in [API level 37](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  
Also in [T Extensions 22](https://developer.android.com/sdkExtensions)

```
public String getDisplayNameAttribute ()
```

Return the attribute to use to display the service in system UI service picker.

Attributes are as per `https://developer.android.com/reference/android/net/nsd/NsdServiceInfo#getAttributes()`.

If null, the service name as per `https://developer.android.com/reference/android/net/nsd/NsdServiceInfo#getServiceName()` is used.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/java/lang/String` | <br /> |

**See also:**

- `https://developer.android.com/reference/android/net/nsd/DiscoveryRequest#FLAG_SHOW_PICKER`

### getFlags

Added in [API level 37](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  
Also in [T Extensions 22](https://developer.android.com/sdkExtensions)

```
public long getFlags ()
```

Returns the discovery flags.

<br />

| Returns ||
|---|---|
| `long` | Value is either `0` or a combination of the following: - `https://developer.android.com/reference/android/net/nsd/DiscoveryRequest#FLAG_NO_PICKER` - `https://developer.android.com/reference/android/net/nsd/DiscoveryRequest#FLAG_SHOW_PICKER` - `https://developer.android.com/reference/android/net/nsd/DiscoveryRequest#FLAG_USER_APPROVED_ONLY` |

### getNetwork

Added in [API level 35](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  
Also in [T Extensions 12](https://developer.android.com/sdkExtensions)

```
public Network getNetwork ()
```

Returns the `https://developer.android.com/reference/android/net/Network` on which the query should be sent or `null` if no
network is specified.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/net/Network` | <br /> |

### getServiceNameFilter

Added in [API level 37](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  
Also in [T Extensions 22](https://developer.android.com/sdkExtensions)

```
public PatternMatcher getServiceNameFilter ()
```

Returns the filter to apply to service names as per `https://developer.android.com/reference/android/net/nsd/NsdServiceInfo#getServiceName()`.

As per RFC6335 5.1., service names must be only US-ASCII letters, digits and hyphens,
and matching is not case-sensitive.

If null, services are not filtered by name.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/os/PatternMatcher` | <br /> |

### getServiceType

Added in [API level 35](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  
Also in [T Extensions 12](https://developer.android.com/sdkExtensions)

```
public String getServiceType ()
```

Returns the service type in format of dot-joint string of two labels.

For example, "_ipp._tcp" for internet printer and "_matter._tcp" for [Matter](https://csa-iot.org/all-solutions/matter) operational device.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/java/lang/String` | This value cannot be `null`. <br /> |

### getSubtype

Added in [API level 35](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  
Also in [T Extensions 12](https://developer.android.com/sdkExtensions)

```
public String getSubtype ()
```

Returns the subtype without the trailing "._sub" label or `null` if no subtype is
specified.

For example, the return value will be "_printer" for subtype "_printer._sub".

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/java/lang/String` | <br /> |

### hashCode

Added in [API level 35](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public int hashCode ()
```

Returns a hash code value for the object. This method is
supported for the benefit of hash tables such as those provided by
`https://developer.android.com/reference/java/util/HashMap`.


The general contract of `hashCode` is:

- Whenever it is invoked on the same object more than once during an execution of a Java application, the `hashCode` method must consistently return the same integer, provided no information used in `equals` comparisons on the object is modified. This integer need not remain consistent from one execution of an application to another execution of the same application.
- If two objects are equal according to the `https://developer.android.com/reference/java/lang/Object#equals(java.lang.Object)` method, then calling the `hashCode` method on each of the two objects must produce the same integer result.
- It is *not* required that if two objects are unequal according to the `https://developer.android.com/reference/java/lang/Object#equals(java.lang.Object)` method, then calling the `hashCode` method on each of the two objects must produce distinct integer results. However, the programmer should be aware that producing distinct integer results for unequal objects may improve the performance of hash tables.

<br />

<br />

| Returns ||
|---|---|
| `int` | a hash code value for this object. <br /> |

### toString

Added in [API level 35](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public String toString ()
```

Returns a string representation of the object.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/java/lang/String` | a string representation of the object. <br /> |

### writeToParcel

Added in [API level 35](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public void writeToParcel (Parcel dest, 
                int flags)
```

Flatten this object in to a Parcel.

<br />

| Parameters ||
|---|---|
| `dest` | `Parcel`: This value cannot be `null`. <br /> |
| `flags` | `int`: Additional flags about how the object should be written. May be 0 or `https://developer.android.com/reference/android/os/Parcelable#PARCELABLE_WRITE_RETURN_VALUE`. Value is either `0` or a combination of the following: - `https://developer.android.com/reference/android/os/Parcelable#PARCELABLE_WRITE_RETURN_VALUE` |