# Playlist Methods

Control Studio playlist navigation. Advance pages, go back, or dynamically adjust page duration for interactive content.

# Playlist Methods

Control Studio playlist navigation and timing.

## Overview

The Playlist Methods allow applications embedded within Studio pages to control playlist navigation. Applications can advance to the next page, return to the previous page, or dynamically adjust the current page's display duration.

**Note:** These methods are specific to applications running within Studio pages. They're not available to root applications.

## Importing

```typescript
import { playlist } from '@telemetryos/sdk';
```

## Methods

### nextPage()

Advance to the next page in the playlist.

**Signature:**

```typescript
async nextPage(): Promise<boolean>
```

**Returns:** `Promise<boolean>` - `true` if successful

**Example:**

```typescript
// Move to next page after user interaction
button.addEventListener('click', async () => {
  await playlist().nextPage();
});
```

**Throws:** Error if operation fails

### previousPage()

Return to the previous page in the playlist.

**Signature:**

```typescript
async previousPage(): Promise<boolean>
```

**Returns:** `Promise<boolean>` - `true` if successful

**Example:**

```typescript
// Go back to previous page
await playlist().previousPage();
```

**Throws:** Error if operation fails

### setDuration()

Set the display duration for the current page.

**Signature:**

```typescript
async setDuration(duration: number): Promise<boolean>
```

**Parameters:**

* `duration` - Duration in milliseconds

**Returns:** `Promise<boolean>` - `true` if successful

**Example:**

```typescript
// Set page to display for 30 seconds
await playlist().setDuration(30000);
```

**Throws:** Error if operation fails

## Next Steps

* **[Overrides API](./overrides-methods.md)** - Emergency alerts and content overrides
* **[Storage API](./storage-methods.md)** - Persist navigation state
* **[Code Examples](../Development/code-examples.md)** - Complete playlist control examples