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

# Connection.RttTextStream

*** ** * ** ***

` public static final class Connection.RttTextStream `   
` extends https://developer.android.com/reference/java/lang/Object ` ` `

|---|---|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object) ||
| ↳ | android.telecom.Connection.RttTextStream |

<br />

*** ** * ** ***

Provides methods to read and write RTT data to/from the in-call app.

## Summary

| ### Public methods ||
|---|---|
| ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/android/telecom/Connection.RttTextStream#read()() ` Reads a string from the in-call app, blocking if there is no data available. |
| ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/android/telecom/Connection.RttTextStream#readImmediately()() ` Non-blocking version of `https://developer.android.com/reference/android/telecom/Connection.RttTextStream#read()`. |
| ` void` | ` https://developer.android.com/reference/android/telecom/Connection.RttTextStream#write(java.lang.String)(https://developer.android.com/reference/java/lang/String input) ` Writes the string `input` into the text stream to the UI for this RTT call. |

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

### read

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

```
public String read ()
```

Reads a string from the in-call app, blocking if there is no data available. Returns `null` if the RTT conversation has been terminated and there is no further data to read.

This method is not thread-safe -- calling it from multiple threads simultaneously may lead to interleaved text.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/java/lang/String` | A string containing text entered by the user, or `null` if the conversation has been terminated or if there was an error while reading. <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/io/IOException` |   |

### readImmediately

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

```
public String readImmediately ()
```

Non-blocking version of `https://developer.android.com/reference/android/telecom/Connection.RttTextStream#read()`. Returns `null` if there is nothing to be read.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/java/lang/String` | A string containing text entered by the user, or `null` if the user has not entered any new text yet. <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/io/IOException` |   |

### write

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

```
public void write (String input)
```

Writes the string `input` into the text stream to the UI for this RTT call. Since RTT transmits text in real-time, this method should be called as often as text snippets are received from the remote user, even if it is only one character.

This method is not thread-safe -- calling it from multiple threads simultaneously may lead to interleaved text.

<br />

| Parameters ||
|---|---|
| `input` | `String`: The message to send to the in-call app. <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/io/IOException` |   |