> Fetch clean Markdown by appending `.md` to any page URL under https://signalwire.com/docs or requesting it with the HTTP header `Accept: text/markdown`. The root index at https://signalwire.com/docs/llms.txt lists the available documentation indexes.

# createScreenShareObject

> createScreenShareObject method for the RoomSession class.

* **createScreenShareObject**(`opts`): `Promise<RoomSessionScreenShare>` - See [RoomSessionScreenShare documentation](/docs/browser-sdk/v3/js/reference/video/room-session-screen-share) for more details.

> **Warning**
>
> Deprecated. Use [startScreenShare](/docs/browser-sdk/v3/js/reference/video/room-session/start-screen-share) instead.

Adds a screen sharing instance to the room. You can create multiple screen sharing instances and add all of them to the room.

#### Parameters

**`opts`** `object`

Object containing the parameters of the method.

---

**`audio`** `boolean | MediaTrackConstraints`

Audio constraints to use when joining the room. Default: `true`.

---

**`autoJoin`** `boolean`

Whether the screen share object should automatically join the room.

---

**`video`** `boolean | MediaTrackConstraints`

Video constraints to use when joining the room. Default: `true`.

---

#### Returns

`Promise<RoomSessionScreenShare>` - See [RoomSessionScreenShare documentation](/docs/browser-sdk/v3/js/reference/video/room-session-screen-share) for more details.

#### Permissions

* `room.self.screenshare`

You need to specify the permissions when [creating the Video Room Token](/docs/apis/rest/video/room-tokens/create-room-token) on the server side.

#### Example

Sharing the screen together with the associated audio:

```javascript
await roomSession.createScreenShareObject({ audio: true, video: true });
```

> createScreenShareObject method for the RoomSession class.