Added in [API level 37](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) Summary: [Methods](https://developer.android.com/reference/android/app/privatecompute/PccClient#pubmethods) \| [Inherited Methods](https://developer.android.com/reference/android/app/privatecompute/PccClient#inhmethods)

# PccClient

*** ** * ** ***

` public class PccClient `   
` extends https://developer.android.com/reference/java/lang/Object ` ` `

|---|---|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object) ||
| ↳ | android.app.privatecompute.PccClient |

<br />

*** ** * ** ***

Provides a connection to a PCC service.

## Summary

| ### Public methods ||
|---|---|
| ` static https://developer.android.com/reference/android/app/privatecompute/PccClient` | ` https://developer.android.com/reference/android/app/privatecompute/PccClient#createInstance(android.content.Context,%20android.os.IBinder)(https://developer.android.com/reference/android/content/Context context, https://developer.android.com/reference/android/os/IBinder binder) ` Factory method to create an instance of PccClient. |
| ` void` | ` https://developer.android.com/reference/android/app/privatecompute/PccClient#sendData(android.os.Bundle)(https://developer.android.com/reference/android/os/Bundle data) ` Sends a Bundle of data to the connected PCC service. |

### 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*.

## Public methods

### createInstance

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

```
public static PccClient createInstance (Context context, 
                IBinder binder)
```

Factory method to create an instance of PccClient. This should be called from onServiceConnected() with the IBinder received from the system

Example:

    private final ServiceConnection mConnection = new ServiceConnection() {
      @Override
      public void onServiceConnected(ComponentName className, IBinder service) {
        mClient = PccClient.createInstance(MainActivity.this, service);
      }

      @Override
      public void onServiceDisconnected(ComponentName className) {
        mClient = null;
      }
    };

    //...
    bindService(intent, mConnection, flags);

<br />

<br />

| Parameters ||
|---|---|
| `context` | `Context`: The Context from the calling component. This value cannot be `null`. <br /> |
| `binder` | `IBinder`: The IBinder object received from the service connection. This value cannot be `null`. <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/app/privatecompute/PccClient` | A new instance of PccClient. <br /> |

### sendData

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

```
public void sendData (Bundle data)
```

Sends a Bundle of data to the connected PCC service. The Bundle is sanitized to enforce one-way data flow if the caller isn't allowed two-way communication with PCC components.

<br />

| Parameters ||
|---|---|
| `data` | `Bundle`: The Bundle of data to send. This value cannot be `null`. <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/lang/IllegalArgumentException` | if the Bundle contains unsafe data types and the caller isn't allowed two way communication with PCC components. To enforce a strictly one-way data flow, the `Bundle` is sanitized to prevent objects that can be used to establish a two-way communication channel like IBinder, Messenger, etc. Allowed data types are: - Primitives and their arrays (e.g., int, char, boolean, String, byte\[\]) - `https://developer.android.com/reference/android/os/PersistableBundle` - Read-only `https://developer.android.com/reference/android/os/ParcelFileDescriptor` - `https://developer.android.com/reference/android/os/SharedMemory` (must be read-only, or will be set to read-only) - `https://developer.android.com/reference/android/graphics/Bitmap` - Custom `https://developer.android.com/reference/android/os/Parcelable` objects must be serialized as a `byte[]`. - Nested `Bundle` objects, which are recursively sanitized. Throws `IllegalArgumentException` if the depth exceeds 100. |
| `https://developer.android.com/reference/java/lang/IllegalStateException` | if sendData is called after the service has been killed by the system |
| `https://developer.android.com/reference/java/lang/RuntimeException` | if the PCC service is unavailable for any other reason. |
| `https://developer.android.com/reference/java/lang/SecurityException` | if the packageName from the passed context does not match the actual package name of the app. |