프레젠테이션 API

제어 사용자 에이전트는 MUST 다음 partial interface를 구현해야 합니다:

WebIDLpartial interface Presentation {
  attribute PresentationRequest? defaultRequest;
};

defaultRequest 속성은 MUST 기본 프레젠테이션 요청이 있으면 반환하고, 없으면 null을 반환해야 합니다. 값을 설정할 때 기본 프레젠테이션 요청을 새 값으로 MUST 설정해야 합니다.

제어 사용자 에이전트는 SHOULD 사용자가 버튼 클릭 등 브라우저 크롬에서 의도를 명확히 했을 때만 기본 프레젠테이션 요청을 사용해 프레젠테이션을 시작해야 합니다.

기본 프레젠테이션 요청을 사용해 프레젠테이션을 시작하려면, 제어 사용자 에이전트는 MUST 기본 프레젠테이션 요청으로 프레젠테이션 시작 단계를 따라야 합니다.

기본 프레젠테이션 요청을 사용한 프레젠테이션 시작 지원은 OPTIONAL입니다.

수신 사용자 에이전트는 MUST 다음 partial interface를 구현해야 합니다:

WebIDLpartial interface Presentation {
  readonly attribute PresentationReceiver? receiver;
};

receiver 속성은 MUST PresentationReceiver 인스턴스를 반환해야 하며, 이는 수신 브라우징 컨텍스트와 연결되어 있고, 수신 사용자 에이전트가 수신 브라우징 컨텍스트를 생성할 때 만듭니다. 그 외의 브라우징 컨텍스트(수신 브라우징 컨텍스트의 자식 navigable 포함)에서는 MUST null을 반환해야 합니다.

PresentationRequest 생성자가 호출되면, 제어 사용자 에이전트는 MUST 다음 단계를 실행해야 합니다:

입력

url 또는 urls, 프레젠테이션 요청 URL

출력

새 PresentationRequest 객체

1. 문서 객체의 active sandboxing flag set에 sandboxed presentation browsing context flag 가 설정되어 있으면, SecurityError를 발생시키고 단계를 중단한다.
2. urls가 빈 시퀀스라면, throw NotSupportedError 예외를 발생시키고 모든 남은 단계를 중단한다.
3. 단일 url이 제공된 경우, urls를 그 url 하나만 담은 배열로 한다.
4. presentationUrls를 빈 URL 리스트로 한다.
5. urls의 각 URL U에 대해:
   1. A를 현재 settings object가 지정한 API base URL에 대해 U를 파싱한 결과의 절대 URL로 한다.
   2. URL 파싱 알고리즘이 실패했다면, throw SyntaxError 예외를 발생시키고 모든 남은 단계를 중단한다.
   3. A의 scheme이 제어 사용자 에이전트에서 지원된다면, presentationUrls에 A를 추가한다.
6. presentationUrls가 빈 리스트라면, NotSupportedError를 발생시키고 모든 남은 단계를 중단한다.
7. presentationUrls의 어떤 멤버라도 잠재적으로 신뢰할 수 있는 URL이 아니라면, SecurityError를 발생시키고 단계를 중단한다.
8. presentationUrls를 프레젠테이션 요청 URL로 하여 새 PresentationRequest 객체를 생성하여 반환한다.

start 메서드가 호출될 때, 사용자 에이전트는 MUST 프레젠테이션 디스플레이를 선택하는 다음 단계를 실행해야 합니다: 프레젠테이션 디스플레이 선택.

입력

presentationRequest, PresentationRequest 객체로, start를 호출받았다.

출력

새 Promise

1. 문서의 active window에 transient activation이 없다면, Promise를 InvalidAccessError 예외와 함께 reject한 뒤 단계를 중단한다.
2. topContext를 최상위 브라우징 컨텍스트로 한다.
3. topContext 또는 그 하위 navigable의 어떤 브라우징 컨텍스트에서라도 이전 start 호출로 unsettled Promise가 있다면, 새 Promise를 OperationError 예외와 함께 reject한 뒤 모든 남은 단계를 중단한다.
4. P를 새 Promise로 한다.
5. P를 반환하되, 다음 단계는 병렬로 계속 실행한다.
6. 사용자 에이전트가 사용 가능한 프레젠테이션 디스플레이 목록 모니터링을 하고 있지 않다면, 사용 가능한 프레젠테이션 디스플레이 목록 모니터링 단계를 병렬로 실행한다.
7. presentationUrls를 프레젠테이션 요청 URL로 한다.
8. 프레젠테이션 디스플레이 활용 및 디스플레이 선택에 대해 사용자 권한을 요청한다.
9. 다음 중 하나가 참이라면:
   1. 사용 가능한 프레젠테이션 디스플레이 목록이 비어 있고, 사용자 권한 요청이 완료되기 전까지도 계속 비어 있을 것이다.
   2. 사용 가능한 프레젠테이션 디스플레이 목록의 어떤 멤버도 presentationUrls의 어떤 멤버에 대해서도 사용 가능한 프레젠테이션 디스플레이가 아니다.
   다음 단계를 실행한다:
   1. Presentation API 태스크를 큐에 추가하여 P를 reject하고, NotFoundError 예외를 전달한다.
   2. 모든 남은 단계를 중단한다.
10. 사용자가 디스플레이 사용 권한을 거부하면, Presentation API 태스크를 큐에 추가하여 P를 NotAllowedError 예외와 함께 reject하고, 모든 남은 단계를 중단한다.
11. 그렇지 않고 사용자가 디스플레이 사용 권한을 허용하면, D를 해당 디스플레이로 한다.
12. 프레젠테이션 연결 시작 단계를 presentationRequest, D, P로 실행한다.

사용자가 브라우저 크롬(전용 버튼, 사용자 제스처 또는 기타 신호)을 통해 문서를 프레젠테이션 디스플레이에 표시하겠다는 의사를 표현하면, 해당 사용자 에이전트는 MUST 아래 단계를 실행하여 기본 프레젠테이션 요청으로 프레젠테이션 시작을 수행해야 합니다. 문서에 기본 프레젠테이션 요청이 설정되어 있지 않으면, 이 단계들은 MUST 실행되지 않아야 합니다.

입력

W, 사용자가 프레젠테이션 시작 의사를 표현한 문서

presentationRequest, W에 설정된 navigator.presentation.defaultRequest의 null이 아닌 값

D, 프레젠테이션 대상으로 지정된 프레젠테이션 디스플레이

1. 아래 단계를 병렬로 실행한다.
2. presentationUrls를 presentationRequest의 프레젠테이션 요청 URL로 한다.
3. D가 presentationRequest의 어떤 프레젠테이션 요청 URL에 대해서도 사용 가능한 프레젠테이션 디스플레이가 아니라면 단계를 중단한다.
4. presentationRequest와 D로 프레젠테이션 연결 시작 단계를 실행한다.

사용자 에이전트가 프레젠테이션 연결 시작을 수행해야 할 때, MUST 아래 단계를 실행합니다:

입력

presentationRequest, 프레젠테이션 연결을 시작하는 데 사용되는 PresentationRequest

D, 선택된 프레젠테이션 디스플레이

P, 새 프레젠테이션 연결로 resolve될 선택적 Promise

1. Assert: 이 단계는 병렬로 실행 중임을 보장한다.
2. I를 제어 중인 프레젠테이션 집합의 모든 알려진 프레젠테이션 연결에 대한 프레젠테이션 식별자 중에서 고유한 유효한 프레젠테이션 식별자로 한다. 지문 채취 방지를 위해, 구현은 SHOULD 프레젠테이션 식별자를 [rfc4122]의 4.4 또는 4.5 형식에 따라 생성된 UUID로 설정해야 합니다.
3. 새 PresentationConnection S를 생성한다.
4. S의 프레젠테이션 식별자를 I로 설정한다.
5. presentationUrls를 presentationRequest의 프레젠테이션 요청 URL로 한다.
6. S의 프레젠테이션 URL을 presentationUrls 중에서 사용 가능한 프레젠테이션 디스플레이 목록에 (presentationUrl, D) 항목이 존재하는 첫 번째 presentationUrl로 설정한다.
7. S의 프레젠테이션 연결 상태를 connecting으로 설정한다.
8. S를 제어 중인 프레젠테이션 집합에 추가한다.
9. P가 제공된 경우, Presentation API 태스크를 큐에 추가하여 P를 S로 resolve한다.
10. Presentation API 태스크를 큐에 추가하여 connectionavailable 이벤트를 PresentationConnectionAvailableEvent 인터페이스를 사용하여, connection 속성을 S로 초기화하여 presentationRequest에서 발생시킨다. 이 이벤트는 버블링되지 않으며 취소할 수 없다.
11. U를 D에 연결된 사용자 에이전트로 한다.
12. 다음 단계가 실패하면, 모든 남은 단계를 중단하고 프레젠테이션 연결 닫기를 S에 대해 error를 closeReason으로, 실패 설명의 사람이 읽을 수 있는 메시지를 closeMessage로 하여 수행한다.
13. 구현별 메커니즘을 사용해 U에게 D, presentationUrl, I를 매개변수로 수신 브라우징 컨텍스트 생성을 수행하도록 알린다.
14. 프레젠테이션 연결 성립을 S로 실행한다.

reconnect 메서드가 호출되면, 사용자 에이전트는 MUST 아래 단계를 실행하여 프레젠테이션에 다시 연결해야 합니다:

입력

presentationRequest, PresentationRequest 객체로, reconnect 메서드가 호출된 대상

presentationId, 유효한 프레젠테이션 식별자

출력

P, 새 Promise

1. P를 새 Promise로 한다.
2. P를 반환하되, 아래 단계들은 병렬로 계속 실행한다.
3. 제어 중인 프레젠테이션 집합에서 다음 조건을 모두 만족하는 PresentationConnection을 검색한다:
   • 그 제어 브라우징 컨텍스트가 현재 브라우징 컨텍스트이다
   • 그 프레젠테이션 연결 상태가 terminated가 아님
   • 그 프레젠테이션 URL이 presentationRequest의 프레젠테이션 요청 URL 중 하나와 동일함
   • 그 프레젠테이션 식별자가 presentationId와 동일함
4. 이러한 PresentationConnection이 존재하면, 다음 단계를 실행한다:
   1. existingConnection을 해당 PresentationConnection로 한다.
   2. Presentation API 태스크를 큐에 추가하여 P를 existingConnection으로 resolve한다.
   3. existingConnection의 프레젠테이션 연결 상태가 connecting 또는 connected이면, 남은 단계를 모두 중단한다.
   4. existingConnection의 프레젠테이션 연결 상태를 connecting으로 설정한다.
   5. 프레젠테이션 연결 성립을 existingConnection으로 실행한다.
   6. 모든 남은 단계를 중단한다.
5. 제어 중인 프레젠테이션 집합에서 다음 조건을 모두 만족하는 첫 번째 PresentationConnection을 검색한다:
   • 그 제어 브라우징 컨텍스트가 현재 브라우징 컨텍스트가 아님
   • 그 프레젠테이션 연결 상태가 terminated가 아님
   • 그 프레젠테이션 URL이 presentationRequest의 프레젠테이션 요청 URL 중 하나와 동일함
   • 그 프레젠테이션 식별자가 presentationId와 동일함
6. 이러한 PresentationConnection이 존재하면, 다음 단계를 실행한다:
   1. existingConnection을 해당 PresentationConnection로 한다.
   2. 새 PresentationConnection newConnection을 생성한다.
   3. newConnection의 프레젠테이션 식별자를 presentationId로 설정한다.
   4. newConnection의 프레젠테이션 URL을 existingConnection의 프레젠테이션 URL로 설정한다.
   5. newConnection의 프레젠테이션 연결 상태를 connecting으로 설정한다.
   6. newConnection을 제어 중인 프레젠테이션 집합에 추가한다.
   7. Presentation API 태스크를 큐에 추가하여 P를 newConnection으로 resolve한다.
   8. Presentation API 태스크를 큐에 추가하여 connectionavailable 이벤트를 PresentationConnectionAvailableEvent 인터페이스를 사용하여, connection 속성을 newConnection으로 초기화하여 presentationRequest에서 발생시킨다. 이벤트는 버블링되지 않고 취소할 수 없다.
   9. 프레젠테이션 연결 성립을 newConnection으로 실행한다.
   10. 모든 남은 단계를 중단한다.
7. Presentation API 태스크를 큐에 추가하여 P를 reject하고, NotFoundError 예외를 전달한다.

아래는 PresentationRequest 인터페이스를 구현하는 객체가 이벤트 핸들러 IDL 속성으로 지원해야 하는 이벤트 핸들러 및 각 이벤트 핸들러의 이벤트 타입입니다:

사용자 에이전트는 MUST 프레젠테이션 가용성 객체 집합을 관리해야 하며, 이는 getAvailability 메서드로 생성됩니다. 프레젠테이션 가용성 객체 집합은 초기값이 빈 튜플 집합 (A, availabilityUrls)로 표현되며, 여기서:

1. A는 live PresentationAvailability 객체
2. availabilityUrls는 PresentationRequest에 대해 getAvailability가 호출될 때의 프레젠테이션 요청 URL 목록

사용자 에이전트는 MUST 사용 가능한 프레젠테이션 디스플레이 목록을 관리해야 합니다. 사용 가능한 프레젠테이션 디스플레이 목록은 튜플 리스트 (availabilityUrl, display)로 표현됩니다. 이 리스트의 항목은 display가 현재 availabilityUrl에 대해 사용 가능한 프레젠테이션 디스플레이임을 의미합니다. 이 프레젠테이션 디스플레이 리스트는 새 프레젠테이션 시작에 사용될 수 있으며, 구현별 디스커버리 메커니즘에 따라 채워집니다. 목록은 사용 가능한 프레젠테이션 디스플레이 목록 모니터링 알고리즘의 최신 결과로 설정됩니다.

프레젠테이션 가용성 객체 집합이 비어 있지 않은 동안, 사용자 에이전트는 MAY 사용 가능한 프레젠테이션 디스플레이 목록 모니터링을 지속적으로 수행하여, 페이지가 value 속성을 활용해 실제 사용 가능한 디스플레이가 있을 때만 프레젠테이션을 제공할 수 있게 합니다. 단, 사용자 에이전트가 백그라운드에서 지속적 가용성 모니터링을 지원하지 않을 수도 있습니다(플랫폼 또는 전력 소비 제약 등). 이 경우 Promise는 getAvailability에서 reject되고, 사용 가능한 프레젠테이션 디스플레이 목록 모니터링 알고리즘은 프레젠테이션 디스플레이 선택 알고리즘의 일부로만 실행됩니다.

프레젠테이션 가용성 객체 집합이 비어 있으면(즉, 모니터링 중인 availabilityUrls가 없다면) 사용자 에이전트는 SHOULD NOT 사용 가능한 프레젠테이션 디스플레이 목록 모니터링을 수행하여 전력 절감 비기능 요구사항을 만족해야 합니다. 추가 전력 절감을 위해 사용자 에이전트는 PresentationAvailability 객체를 가진 페이지가 포그라운드에 있는지 여부도 추적할 수 있습니다. 이를 활용해 구현별 디스커버리 동작을 재개 또는 중지할 수 있습니다.

getAvailability 메서드가 호출되면, 사용자 에이전트는 MUST 아래 단계를 실행합니다:

입력

presentationRequest, PresentationRequest 객체로, getAvailability가 호출됨

출력

새 Promise

1. P를 presentationRequest의 JavaScript realm에서 생성된 새 Promise로 한다.
2. P를 반환하되, 아래 단계는 병렬로 계속 실행한다.
3. 사용자 에이전트가 백그라운드에서 사용 가능한 프레젠테이션 디스플레이 목록 모니터링을 지속적으로 수행할 수 없다면, 나중에 연결을 시작할 때 프레젠테이션 디스플레이를 발견할 수 있다면 다음을 실행한다:
   1. Presentation API 태스크를 큐에 추가하여 P를 NotSupportedError 예외로 reject한다.
   2. 모든 남은 단계를 중단한다.
4. presentationRequest의 프레젠테이션 디스플레이 가용성이 null이 아니면:
   1. Presentation API 태스크를 큐에 추가하여 P를 해당 요청의 프레젠테이션 디스플레이 가용성으로 resolve한다.
   2. 모든 남은 단계를 중단한다.
5. presentationRequest의 프레젠테이션 디스플레이 가용성을 presentationRequest의 JavaScript realm에서 생성된 새 PresentationAvailability 객체로 설정하고, A를 해당 객체로 한다.
6. 튜플 (A, presentationUrls)을 생성하여 프레젠테이션 가용성 객체 집합에 추가한다.
7. 사용 가능한 프레젠테이션 디스플레이 목록 모니터링 알고리즘을 실행한다.
   참고

   모니터링 알고리즘은 직전 단계 이후 추가된 튜플을 처리하기 위해 최소 한 번 더 실행되어야 합니다.
8. Presentation API 태스크를 큐에 추가하여 P를 A로 resolve한다.

프레젠테이션 가용성 객체 집합이 비어 있지 않거나, 프레젠테이션 디스플레이 선택의 대기 중인 요청이 있다면, 사용자 에이전트는 MUST 아래 단계를 실행하여 사용 가능한 프레젠테이션 디스플레이 목록 모니터링을 수행해야 합니다:

1. Assert: 이 단계는 병렬로 실행됨을 보장합니다.
2. availabilitySet을 프레젠테이션 가용성 객체 집합의 얕은 복사본으로 한다.
3. 프레젠테이션 디스플레이 선택의 대기 중인 요청이 있고, 해당 PresentationRequest의 프레젠테이션 디스플레이 가용성이 null이면, 아래 하위 단계를 실행한다:
   1. A를 새 PresentationAvailability 객체로 한다.
   2. 튜플 (A, presentationUrls)을 생성하며, presentationUrls는 해당 PresentationRequest의 프레젠테이션 요청 URL이다. 이를 availabilitySet에 추가한다.
4. newDisplays를 빈 리스트로 한다.
5. 사용자 에이전트가 프레젠테이션 디스플레이를 검색할 수 없다면(예시: 사용자가 해당 기능을 비활성화함), 다음 단계를 건너뛴다.
6. 구현별 메커니즘을 사용하여 프레젠테이션 디스플레이를 검색하고, newDisplays에 그 리스트를 설정한다.
7. 사용 가능한 프레젠테이션 디스플레이 목록을 빈 리스트로 설정한다.
8. availabilitySet의 각 멤버 (A, availabilityUrls)에 대해 아래 단계를 실행한다:
   1. previousAvailability를 A의 value 속성 값으로 한다.
   2. newAvailability를 false로 한다.
   3. availabilityUrls의 각 availabilityUrl에 대해:
      1. newDisplays의 각 display에 대해, display가 availabilityUrl에 대해 사용 가능한 프레젠테이션 디스플레이라면, 아래 단계를 실행한다:
         1. 동일한 튜플이 이미 없으면 사용 가능한 프레젠테이션 디스플레이 목록에 (availabilityUrl, display) 튜플을 추가한다.
         2. newAvailability를 true로 설정한다.
   4. A의 value 속성이 아직 초기화되지 않았다면, A의 value 속성을 newAvailability로 설정하고, 다음 단계를 건너뛴다.
   5. previousAvailability와 newAvailability가 다르면, Presentation API 태스크를 큐에 추가하여 아래 단계를 실행한다:
      1. A의 value 속성을 newAvailability로 설정한다.
      2. change 이벤트 발생을 A에서 실행한다.

프레젠테이션 디스플레이 가용성 객체가 가비지 컬렉션 대상이 되면, 사용자 에이전트는 SHOULD 다음 단계를 실행해야 합니다:

1. A를 새로 사망한 PresentationAvailability 객체로 한다.
2. 프레젠테이션 가용성 객체 집합에서 (A, availabilityUrl) 항목을 찾아 제거한다.
3. 이제 프레젠테이션 가용성 객체 집합이 비어 있고, 프레젠테이션 디스플레이 선택의 대기 중인 요청이 없다면, 전력 절감을 위해 사용 가능한 프레젠테이션 디스플레이 목록 모니터링의 대기 중인 태스크를 취소하고, 사용 가능한 프레젠테이션 디스플레이 목록을 빈 리스트로 설정한다.

WebIDL[SecureContext, Exposed=Window]
interface PresentationConnectionAvailableEvent : Event {
  constructor(DOMString type, PresentationConnectionAvailableEventInit eventInitDict);
  [SameObject] readonly attribute PresentationConnection connection;
};

dictionary PresentationConnectionAvailableEventInit : EventInit {
  required PresentationConnection connection;
};

제어 사용자 에이전트는 연결이 객체에 대해 생성될 때 이벤트를 발생시킵니다. 이벤트 이름은 connectionavailable이고, PresentationRequest에 연결된 인스턴스에서 발생합니다. 이 이벤트는 PresentationRequest 인스턴스에서 PresentationConnectionAvailableEvent 인터페이스를 사용하여 발생하고, connection 속성은 새로 생성된 PresentationConnection 객체로 설정됩니다. 이 이벤트는 컨트롤러에 대해 생성된 각 연결에 대해 발생합니다. 이는 컨트롤러가 start 또는 reconnect를 호출하거나, 제어 사용자 에이전트가 defaultRequest를 통해 컨트롤러를 대신하여 연결을 생성할 때 발생합니다.

수신 사용자 에이전트는 들어오는 연결이 생성될 때 이벤트를 발생시킵니다. 이벤트 이름은 connectionavailable이며, PresentationReceiver에 대해 들어오는 연결이 생성될 때 발생합니다. 이 이벤트는 프레젠테이션 컨트롤러 모니터에서, PresentationConnectionAvailableEvent 인터페이스를 사용하여 발생하며, connection 속성은 생성된 PresentationConnection 객체로 설정됩니다. 이 이벤트는 들어오는 프레젠테이션 연결 모니터링 시 생성되는 모든 연결에 대해 발생합니다.

connection 속성은 MUST PresentationConnection 객체가 생성될 때 설정된 값을 반환해야 합니다.

PresentationConnectionAvailableEvent 생성자가 호출되면, 사용자 에이전트는 MUST PresentationConnectionAvailableEvent 객체를 생성하며, connection 속성은 생성자에 전달된 connection 멤버와, PresentationConnectionAvailableEventInit 객체에서 설정합니다.

사용자 에이전트가 프레젠테이션 연결 성립을 프레젠테이션 연결을 사용해 수행할 때, MUST 다음 단계를 실행해야 합니다:

입력

presentationConnection, 연결할 PresentationConnection 객체

1. Assert: 이 단계는 병렬로 실행 중임을 보장한다.
2. presentationConnection의 프레젠테이션 연결 상태가 connecting이 아니라면, 남은 단계를 모두 중단한다.
3. presentationConnection을 수신 브라우징 컨텍스트에 연결하도록 요청한다. presentationConnection의 프레젠테이션 식별자는 이 요청에 MUST 포함되어야 한다.
4. 연결이 성공적으로 완료되면, Presentation API 태스크를 큐에 추가하여 아래 단계를 실행한다:
   1. presentationConnection의 프레젠테이션 연결 상태를 connected로 설정한다.
   2. connect 이벤트 발생을 presentationConnection에서 실행한다.
5. 연결을 완료할 수 없다면, 프레젠테이션 연결 닫기를 S에 대해 error를 closeReason으로, 실패를 설명하는 사람이 읽을 수 있는 메시지를 closeMessage로 하여 실행한다.

프레젠테이션 메시지 데이터는 두 브라우징 컨텍스트 사이에서 전송되는 페이로드 데이터입니다. 프레젠테이션 메시지 타입은 해당 데이터의 타입으로, text 또는 binary 중 하나입니다.

사용자 에이전트가 메시지 전송 알고리즘을 프레젠테이션 연결을 통해 수행할 때, MUST 다음 단계를 실행해야 합니다:

입력

presentationConnection, 상대 브라우징 컨텍스트에 연결된 프레젠테이션 연결

messageOrData, 상대 브라우징 컨텍스트에 전송할 프레젠테이션 메시지 데이터

1. presentationConnection의 state 속성이 connected가 아니라면, InvalidStateError 예외를 발생시킨다.
2. presentationConnection의 닫기 절차가 시작되었다면, 이 단계를 중단한다.
3. 프레젠테이션 메시지 타입 messageType을 messageOrData가 ArrayBuffer, ArrayBufferView, 또는 Blob 타입이면 binary로 한다. messageOrData가 DOMString 타입이면 text로 한다.
4. 구현별 메커니즘을 사용해 messageOrData의 내용을 프레젠테이션 메시지 데이터로, messageType을 프레젠테이션 메시지 타입으로 목적지 브라우징 컨텍스트에 전송한다.
5. 이전 단계에서 복구 불가능한 오류가 발생하면, 즉시 프레젠테이션 연결 닫기를 presentationConnection에 대해 error를 closeReason으로, 오류 설명이 담긴 closeMessage로 실행한다.

사용자 에이전트가 원격 측으로부터 프레젠테이션 메시지 데이터와 프레젠테이션 메시지 타입으로 이루어진 전송을 수신했을 때, MUST 아래 단계를 실행하여 메시지 수신을 PresentationConnection을 통해 수행해야 합니다:

입력

presentationConnection, 메시지를 수신하는 프레젠테이션 연결

messageType, 메시지의 프레젠테이션 메시지 타입

messageData, 메시지의 프레젠테이션 메시지 데이터

1. Assert: 이 단계는 병렬로 실행 중임을 보장한다.
2. presentationConnection의 state 속성이 connected가 아니면, 남은 단계를 중단한다.
3. event를 이벤트 생성 결과로 한다. MessageEvent 인터페이스를 사용하며, 이벤트 타입은 message이고 버블링되지 않으며 취소되지 않는다.
4. event의 data 속성을 다음과 같이 초기화한다:
   1. messageType이 text이면, event의 data 속성을 DOMString 타입의 messageData로 초기화한다.
   2. messageType이 binary이고 binaryType 속성이 "blob"이면, event의 data 속성을 messageData를 raw data로 하는 새로운 Blob 객체로 초기화한다.
   3. messageType이 binary이고 binaryType 속성이 "arraybuffer"이면, event의 data 속성을 messageData를 내용으로 하는 새로운 ArrayBuffer 객체로 초기화한다.
5. Presentation API 태스크를 큐에 추가하여 event 발생을 presentationConnection에서 event로 실행한다.

사용자 에이전트가 presentationConnection을 통해 메시지 수신 중 복구 불가능한 오류를 만난 경우, MUST 즉시 프레젠테이션 연결 닫기를 presentationConnection에 대해 error를 closeReason으로 실행해야 합니다. 이때 SHOULD 사람이 읽을 수 있는 오류 설명을 closeMessage로 사용해야 합니다.

WebIDLenum PresentationConnectionCloseReason { "error", "closed", "wentaway" };

[SecureContext, Exposed=Window]
interface PresentationConnectionCloseEvent : Event {
  constructor(DOMString type, PresentationConnectionCloseEventInit eventInitDict);
  readonly attribute PresentationConnectionCloseReason reason;
  readonly attribute DOMString message;
};

dictionary PresentationConnectionCloseEventInit : EventInit {
  required PresentationConnectionCloseReason reason;
  DOMString message = "";
};

PresentationConnectionCloseEvent 이벤트는 프레젠테이션 연결이 closed 상태에 들어갈 때 발생합니다. reason 속성은 연결이 종료된 이유를 제공합니다. 다음 값 중 하나를 가질 수 있습니다: PresentationConnectionCloseReason:

• error 연결 혹은 프레젠테이션과의 통신 수단이 복구 불가능한 오류에 빠졌음을 의미합니다.
• closed 연결된 제어 브라우징 컨텍스트 또는 수신 브라우징 컨텍스트가 close()를 호출했음을 의미합니다.
• wentaway 브라우저가 연결을 종료했음을 의미하며, 예를 들어 연결을 소유한 브라우징 컨텍스트가 내비게이션되거나 폐기된 경우 등입니다.

reason 속성이 error일 때, 사용자 에이전트는 SHOULD message 속성에 통신 채널이 오류에 도달한 방법을 사람이 읽을 수 있도록 기술해야 합니다.

PresentationConnectionCloseEvent 생성자가 호출되면, 사용자 에이전트는 MUST 새로운 PresentationConnectionCloseEvent 객체를 생성하며, reason 속성은 이 생성자에 전달된 reason 멤버로 설정하고, message 속성은 message 멤버가 설정되면 그 값으로, 그렇지 않으면 빈 문자열로 설정합니다.

사용자 에이전트가 프레젠테이션 연결 닫기 시작을 수행할 때, MUST 다음을 실행해야 합니다:

입력

presentationConnection, 닫을 프레젠테이션 연결

closeReason, 연결이 닫히는 이유를 설명하는 PresentationConnectionCloseReason

closeMessage, 연결이 닫힌 이유에 대한 사람이 읽을 수 있는 메시지

1. presentationConnection의 프레젠테이션 연결 상태가 connecting 또는 connected가 아니면 남은 단계를 중단한다.
2. presentationConnection의 프레젠테이션 연결 상태를 closed로 설정한다.
3. 목적지 브라우징 컨텍스트에 해당 PresentationConnection을 닫으려는 의도를 신호로 전달한다. 이때 closeReason을 함께 전달한다. 사용자 에이전트는 대응하는 PresentationConnection이 실제로 닫혔다는 확인을 기다릴 필요 없이 다음 단계로 진행해도 된다.
4. closeReason이 wentaway가 아니면, 로컬에서 프레젠테이션 연결 닫기 단계를 presentationConnection, closeReason, closeMessage로 실행한다.

사용자 에이전트가 프레젠테이션 연결 닫기를 수행할 때, MUST 다음을 실행해야 합니다:

입력

presentationConnection, 닫을 프레젠테이션 연결

closeReason, 연결이 닫히는 이유를 설명하는 PresentationConnectionCloseReason

closeMessage, 연결이 닫힌 이유에 대한 사람이 읽을 수 있는 메시지

1. presentationConnection에 대해 대기 중인 프레젠테이션 연결 닫기 태스크가 있거나, 이미 프레젠테이션 연결 닫기 태스크가 실행된 경우 남은 단계를 중단한다.
2. Presentation API 태스크를 큐에 추가하여 아래 단계를 실행한다:
   1. presentationConnection의 프레젠테이션 연결 상태가 connecting, connected, closed 중 하나가 아니면 남은 단계를 중단한다.
   2. presentationConnection의 프레젠테이션 연결 상태가 closed가 아니면, closed로 설정한다.
   3. presentationConnection이 수신 브라우징 컨텍스트에서 들어오는 프레젠테이션 연결 모니터링 결과로 생성된 경우, 다음 하위 단계를 실행한다.
      1. presentationConnection을 프레젠테이션 컨트롤러 집합에서 제거한다.
      2. 프레젠테이션 컨트롤러 모니터에 프레젠테이션 컨트롤러 집합을 채운다.
   4. close 이벤트 발생을 PresentationConnectionCloseEvent 인터페이스를 사용하여, reason 속성은 closeReason, message 속성은 closeMessage로 초기화하여 presentationConnection에서 발생시킨다. 이벤트는 버블링되지 않으며, 취소할 수 없다.

제어 사용자 에이전트가 제어 브라우징 컨텍스트에서 프레젠테이션 종료를 connection을 사용해 수행할 때, MUST 다음 단계를 실행해야 합니다:

1. connection의 프레젠테이션 연결 상태가 connected 또는 connecting가 아니면 남은 단계를 중단한다.
2. 그렇지 않으면, 제어 사용자 에이전트의 제어 중인 프레젠테이션 집합의 각 known connection에 대해:
   1. known connection과 connection의 프레젠테이션 식별자가 같고, known connection의 프레젠테이션 연결 상태가 connected 또는 connecting이면, 글로벌 태스크를 큐에 추가하여 프레젠테이션 태스크 소스의 known connection의 관련 글로벌 오브젝트에서 아래 단계를 실행한다:
      1. known connection의 프레젠테이션 연결 상태를 terminated로 설정한다.
      2. terminate 이벤트 발생을 known connection에서 실행한다.
3. 병렬로, 구현별 메커니즘을 사용하여 프레젠테이션 종료 요청(send a termination request)을 해당 수신 사용자 에이전트에 전달한다.

다음 중 하나가 발생하면 수신 사용자 에이전트는 MUST 수신 브라우징 컨텍스트에서 프레젠테이션 종료를 실행해야 합니다:

1. 수신 사용자 에이전트가 해당 수신 브라우징 컨텍스트에 대응하는 문서를 언로드해야 할 때(예: 브라우징 컨텍스트를 새 리소스로 내비게이트 요청 시)
2. 사용자가 수신 사용자 에이전트를 통해 프레젠테이션 종료를 요청했을 때
   참고

   이는 명시적인 사용자 동작으로 발생할 수 있고, 사용자 에이전트의 정책에 따라 발생할 수도 있습니다. 예를 들어 수신 사용자 에이전트가 PresentationConnection 객체가 모두 30분간 닫힌 경우 프레젠테이션을 종료하도록 설정될 수 있습니다.

3. 제어 사용자 에이전트가 해당 프레젠테이션에 대해 종료 요청을 전송한 경우 수신 사용자 에이전트에 도달

수신 사용자 에이전트가 수신 브라우징 컨텍스트에서 프레젠테이션 종료를 실행해야 할 때, MUST 아래 단계를 실행합니다:

1. P를 종료할 프레젠테이션으로, allControllers를 해당 프레젠테이션을 위해 생성된 프레젠테이션 컨트롤러 집합으로, connectedControllers를 빈 리스트로 한다.
2. allControllers의 각 connection에 대해 아래 단계를 실행한다:
   1. connection의 프레젠테이션 연결 상태가 connected이면, connection을 connectedControllers에 추가한다.
   2. connection의 프레젠테이션 연결 상태를 terminated로 설정한다.
3. P에 대해 수신 브라우징 컨텍스트가 있고, 그 컨텍스트의 문서가 언로드되지 않았다면, 해당 문서 언로드를 수행하고 UI에서 해당 브라우징 컨텍스트를 제거 및 폐기한다.
4. connectedControllers의 각 connection에 대해 구현별 메커니즘을 사용해 P에 대한 종료 확인을 해당 제어 사용자 에이전트(해당 connection의 목적지 브라우징 컨텍스트의 소유자)로 전송한다.
   참고

   제어 사용자 에이전트마다 종료 확인은 한 번만 전송하면 됩니다.

수신 사용자 에이전트가 프레젠테이션 P에 대해 종료 확인을 전송하고, 해당 확인이 제어 사용자 에이전트에 도달한 경우, 제어 사용자 에이전트는 MUST 아래 단계를 실행해야 합니다:

1. P에 연결된 제어 중인 프레젠테이션 집합의 각 connection에 대해, 글로벌 태스크를 큐에 추가하여 프레젠테이션 태스크 소스의 connection의 관련 글로벌 오브젝트에서 아래 단계를 실행한다:
   1. connection의 프레젠테이션 연결 상태가 connected 또는 connecting가 아니면 남은 단계를 중단한다.
   2. connection의 프레젠테이션 연결 상태를 terminated로 설정한다.
   3. terminate 이벤트 발생을 connection에서 실행한다.

아래는 PresentationConnection 인터페이스를 구현하는 객체가 이벤트 핸들러 IDL 속성으로 지원해야 하는 이벤트 핸들러 및 각 이벤트 핸들러의 이벤트 타입입니다:

사용자 에이전트가 수신 브라우징 컨텍스트 생성을 수행할 때, MUST 아래 단계를 실행해야 합니다:

입력

D, 사용자가 선택한 프레젠테이션 디스플레이

presentationUrl, 프레젠테이션 요청 URL

presentationId, 프레젠테이션 식별자

1. 새 브라우징 컨텍스트 생성을 통해 새로운 최상위 브라우징 컨텍스트 C를 생성하고, D에 표시하도록 설정한다.
2. C의 세션 히스토리를 빈 리스트로 설정한다.
3. C에 sandboxed modals flag와 sandboxed auxiliary navigation browsing context flag를 설정한다.
4. 수신 사용자 에이전트가 [PERMISSIONS]을 구현한다면, C의 모든 권한 상태를 "denied"로 설정한다.
5. C에 대해 새로운 빈 쿠키 저장소를 생성한다.
6. C에 대해 HTTP 인증 상태 저장소를 새로 생성한다.
7. C에 대해 세션 스토리지 영역과 로컬 스토리지 영역을 위한 빈 저장소를 생성한다.
8. 수신 사용자 에이전트가 [INDEXEDDB]를 구현한다면, C를 위한 IndexedDB 데이터베이스 저장소를 새로 생성한다.
9. 수신 사용자 에이전트가 [SERVICE-WORKERS]를 구현한다면, C를 위한 새로운 빈 서비스 워커 등록 리스트와 빈 Cache 객체 집합을 생성한다.
10. Navigate를 통해 C를 presentationUrl로 이동한다.
11. C에 대해 presentationId와 presentationUrl로 들어오는 프레젠테이션 연결 모니터링을 시작한다.

자식 navigable로, 즉 표시된 문서에 의해 생성된 것들은 수신 브라우징 컨텍스트를 최상위 브라우징 컨텍스트로 가진다. 이들은 위의 2-4번 제한도 MUST 적용받으며, 또한 sandboxed top-level navigation without user activation browsing context flag가 설정되어야 한다. 위 브라우징 컨텍스트들은 5-10번 기능에 대해 동일한 브라우징 상태(스토리지)를 공유해야 한다.

최상위 브라우징 컨텍스트가 새 리소스로 이동하려 시도하고 이동 단계를 실행할 때, MUST 1번 단계를 따라 이동 허용 여부를 판단해야 한다. 또한 MUST NOT 자기 자신을 새로운 리소스로 이동할 수 없으며, 단, fragment identifier로의 이동이나 문서 새로고침만 허용된다.

최상위 브라우징 컨텍스트가 이동 허용되지 않았다면, SHOULD NOT 새 최상위 브라우징 컨텍스트에서 리소스를 열도록 제공해야 하며, 그 외에는 SHOULD 이동 단계와 일치해야 한다.

Window client와 worker client로, 수신 브라우징 컨텍스트와 그 하위 navigable에 연결된 것들은 서로의 서비스 워커에 노출되면 안 된다.

수신 브라우징 컨텍스트가 종료되면, 그와 브라우징 컨텍스트의 하위 navigable에 연결된 모든 서비스 워커는 MUST 등록 해제 및 종료되어야 한다. 수신 브라우징 컨텍스트와 그 브라우징 컨텍스트의 하위 navigable에 연결된 모든 브라우징 상태(스토리지 포함) (세션 히스토리, 쿠키 저장소, HTTP 인증 상태, 데이터베이스, 세션 스토리지 영역, 로컬 스토리지 영역, 서비스 워커 등록 리스트 및 Cache 객체)는 MUST 폐기되어야 하며, 다른 브라우징 컨텍스트에서 재사용될 수 없다.

수신 사용자 에이전트는 SHOULD 수신 브라우징 컨텍스트에서 리소스를 가져올 때 HTTP Accept-Language 헤더를 제어 사용자 에이전트의 언어 선호도에 맞게 설정해야 합니다(즉, 제어 사용자 에이전트가 전송했을 Accept-Language와 동일하게). 이는 수신 사용자 에이전트가 프레젠테이션을 폰트 및 로케일 특화 속성을 포함하여 사용자의 선호에 맞게 렌더링하는 데 도움이 됩니다.

수신 사용자 에이전트가 수신 브라우징 컨텍스트에서 제어 브라우징 컨텍스트로부터 들어오는 프레젠테이션 연결 모니터링을 시작할 때, MUST 구현별 메커니즘을 통해 제어 브라우징 컨텍스트로부터 들어오는 연결 요청을 수신 및 승인해야 합니다. 새로운 연결 요청이 제어 브라우징 컨텍스트로부터 수신되면, 수신 사용자 에이전트는 MUST 다음 단계를 실행해야 합니다:

입력

I, 들어오는 연결 요청과 함께 제어 브라우징 컨텍스트가 전달한 프레젠테이션 식별자

presentationId, 수신 브라우징 컨텍스트 생성에 사용된 프레젠테이션 식별자

presentationUrl, 수신 브라우징 컨텍스트 생성에 사용된 프레젠테이션 요청 URL

1. Assert: 이 단계는 병렬로 실행됨을 보장한다.
2. presentationId와 I가 같지 않으면 연결을 거부하고 남은 단계를 중단한다.
3. 새 PresentationConnection S를 생성한다.
4. S의 프레젠테이션 식별자를 I로 설정한다.
5. S의 프레젠테이션 URL을 presentationUrl로 설정한다.
6. 제어 브라우징 컨텍스트와 수신 브라우징 컨텍스트 간의 연결을 구현별 메커니즘을 통해 성립시킨다.
7. 연결이 성공적으로 성립되면 S의 프레젠테이션 연결 상태를 connected로 설정한다. 그렇지 않으면 S의 프레젠테이션 연결 상태를 closed로 설정하고 남은 단계를 중단한다.
8. S를 프레젠테이션 컨트롤러 집합에 추가한다.
9. presentation controllers monitor가 null이면, 병렬로 아래 단계를 실행한다.
   1. presentation controllers monitor를 PresentationConnectionList의 새 인스턴스로 (해당 PresentationReceiver 객체의 JavaScript realm에서) 설정한다.
   2. presentation controllers monitor를 프레젠테이션 컨트롤러 집합으로 채운다.
   3. presentation controllers promise가 null이 아니면, Presentation API 태스크를 큐에 추가하여 resolve를 presentation controllers promise에 presentation controllers monitor로 실행한다.
   4. 남은 단계를 중단한다.
10. 그 외에는 병렬로 아래 단계를 실행한다.
    1. presentation controllers monitor를 프레젠테이션 컨트롤러 집합으로 채운다.
    2. Presentation API 태스크를 큐에 추가하여 connectionavailable 이벤트 발생을 PresentationConnectionAvailableEvent 인터페이스를 사용하여, connection 속성을 S로 설정하여 presentation controllers monitor에서 발생시킨다. 이벤트는 버블링되지 않으며, 취소할 수 없다.

아래는 PresentationConnectionList 인터페이스를 구현하는 객체가 이벤트 핸들러 IDL 속성으로 지원해야 하는 이벤트 핸들러 및 각 이벤트 핸들러의 이벤트 타입입니다: