` 이름이고 `IVS_STREAM`은 IVS 재생 URL입니다. Amazon IVS 공급자를 설정하고 재생을 활성화하려면 다음을 수행합니다.
1. 플레이어 통합의 최신 버전에 대해 다음 `script` 태그를 포함합니다(이 경우 1.50.0).
```
```
1. `ivs` 유형을 사용하여 IVS 재생 목록 항목을 표시합니다. `setup()`에서 `cast` 값을 `null`로 설정합니다(Chromecast는 지원되지 않기 때문임).
```
jwplayer(JW_PLAYER_DIV).setup({
playlist: [{
file:IVS_STREAM,
type: 'ivs',
}]
});
```
1. 기본 Amazon IVS 플레이어에 대한 참조를 사용하여 Amazon IVS 플레이어 API 호출을 수행하거나 콜백 처리를 위해 Amazon IVS 전용 열거형에 대한 참조를 원하는 경우 `'providerPlayer'` 이벤트에 대한 리스너를 추가합니다.
```
jwplayer(JW_PLAYER_DIV).on('providerPlayer', function (player) {
// player object has 'ivsPlayer' and 'ivsEvents' properties
// ...callback code...
});
```
### 샘플 코드
이 예에서 `JW_PLAYER_LIB`는 JW 플레이어 라이브러리 스크립트의 URL이고 `IVS_STREAM`은 IVS 재생 URL입니다.
```
```
## 이벤트
표준 JW 플레이어 이벤트를 수신하려면 JW 플레이어의 [on](https://docs.jwplayer.com/players/docs/jw8-reference#event-listening-with-the-jwp-api) 함수를 사용합니다.
Amazon IVS에 특정한 이벤트를 수신하거나 Amazon IVS 웹 플레이어에서 이벤트 리스너를 추가 및 제거하려면 `'providerPlayer'` 이벤트를 수신하여 Amazon IVS 플레이어에 대한 참조를 가져온 다음, 여기에 이벤트 수신을 추가해야 합니다. 예:
```
// store a default value for ivsPlayer
var ivsPlayer = {};
// store references to the Amazon IVS Player and Amazon IVS Events:
jwplayer(JW_PLAYER_DIV).on('providerPlayer', function (player) {
ivsPlayer = player.ivsPlayer;
});
// set up event listening
ivsPlayer.addEventListener(event, callback);
ivsPlayer.removeEventListener(event, callback);
```
여기서, `callback`은 정의한 콜백이고 `event`는 `PlayerEventType`, `PlayerState` 또는 `ErrorType` 중 하나입니다. 이벤트에 대한 자세한 내용을 알아보려면, [Amazon IVS Player SDK: Web Reference](https://aws.github.io/amazon-ivs-player-docs/1.50.0/web/)에서 확인하세요.
`'providerPlayer'` 이벤트는 JW 플레이어에 의해 생성되며 등록한 콜백은 다음 필드가 있는 객체를 수신합니다.
| 필드 | 설명 |
| --- | --- |
| `ivsPlayer` | 기본 Amazon IVS 플레이어 인스턴스를 반환합니다. 이 인스턴스를 통해 전체 Amazon IVS 플레이어 웹 API를 사용할 수 있습니다. 가능하면 기본 JW 플레이어 재생 API를 사용하고 Amazon IVS 고유 기능에 액세스하려는 경우에만 이 함수를 사용하는 것이 좋습니다. Amazon IVS 플레이어 인스턴스에서 액세스해야 하는 가장 일반적인 함수는 `removeEventListener()` 및 `addEventListener()`입니다. |
| `ivsEvents` | 해당 Amazon IVS 고유 열거형에 매핑되는 `PlayerEventType`, `PlayerState` 및 `ErrorType` 필드가 있는 객체를 반환합니다. 자세한 내용은 [Amazon IVS Player SDK: Web Reference](https://aws.github.io/amazon-ivs-player-docs/1.50.0/web/)에서 확인하세요. |
## 오류
일반적인 JW 플레이어 오류의 경우 JW 플레이어의 [on](https://docs.jwplayer.com/players/docs/jw8-reference#event-listening-with-the-jwp-api) 함수를 사용하여 오류 이벤트를 수신합니다.
Amazon IVS에 특정한 오류의 경우 Amazon IVS 플레이어에서 자체 오류를 수신합니다.
```
// set default values for ivsPlayer and ivsEvents
var ivsPlayer = {};
var ivsEvents = {};
// store references to the Amazon IVS Player and Amazon IVS Events
jwplayer(JW_PLAYER_DIV).on('providerPlayer', function (player) {
ivsPlayer = player.ivsPlayer;
ivsEvents = player.ivsEvents;
});
// set up event listening:
let playerEvent = ivsEvents.PlayerEventType;
ivsPlayer.addEventListener(playerEvent.ERROR, callback);
```
콜백은 다음 필드가 있는 객체를 수신합니다.
| 필드 | 설명 |
| --- | --- |
| `type` | 오류 유형 `ErrorType` 이벤트에 대응합니다. 자세한 내용은 [Amazon IVS Player SDK: Web Reference](https://aws.github.io/amazon-ivs-player-docs/1.50.0/web/)에서 확인하세요. |
| `code` | 오류 코드입니다. |
| `source` | 오류 소스입니다. |
| `message` | 사람이 읽을 수 있는 오류 메시지입니다. |
## 콘텐츠 보안 정책
Amazon IVS 공급자 API는 콘텐츠 보안 정책(CSP)을 사용하는 페이지에서 작동하도록 구성되어 있습니다. [IVS Player SDK: 웹 설명서](web-content-security-policy.md)의 '콘텐츠 보안 정책 작업' 섹션을 참조하세요.
## 제한 사항
공급자는 캐스팅을 지원하지 않습니다. JW 플레이어 대시보드에서 캐스팅을 활성화한 경우 `setup()` 호출 시 `cast`를 `null`로 설정하여 비활성화할 수 있습니다. 그러면 캐스팅 버튼을 숨깁니다.