# TDSBMPlayerPlayerDelegate Protocol Reference

Conforms to | NSObject
Declared in | TDSBMPlayer.h

## Overview

TDSBMPlayerPlayerDelegate defines methods you can implement to handle connection notifications and to receive cue point events from the TDSBMPlayer.

## Handling cue point events

### `– sbmPlayer:didReceiveCuePointEvent:` required method

Called when there’s a Cue Point available to be processed. A NSDictionary is passed containing the Cue Point metadata. All the available keys are defined in CuePointEvent.h. See STWCue_Metadata_Dictionary.pdf for more details on the available cue point information.

`- (void)sbmPlayer:(TDSBMPlayer *)player didReceiveCuePointEvent:(CuePointEvent *)cuePointEvent`

#### Parameters

`player` | The SBM player which is receiving cue point events
`cuePointEvent` | A CuePointEvent object containing all cue point information.

#### Declared In

`TDSBMPlayer.h`

## Connection state

### `– sbmPlayer:didFailConnectingWithError:` required method

Tells the delegate that the SBM player was unable to connect to the server.

`- (void)sbmPlayer:(TDSBMPlayer *)player didFailConnectingWithError:(NSError *)error`

#### Discussion

The SBM player tries to reconnect automatically three times. It will call this callback method after the third attempt fails.

#### Declared In

`TDSBMPlayer.h`

### `– sbmPlayerDidOpenConnection:`

Called when the SBM player established a connection with the server and is ready to receive cue points.

`- (void)sbmPlayerDidOpenConnection:(TDSBMPlayer *)player`

#### Parameters

`player` | The SBM player whose connection was opened.

#### Declared In

`TDSBMPlayer.h`