110. (Aws/Amazon) [Aws Kinesis Video Streams] Aws ListSignalingChannelsRequest 통해 반환 되는 신호 채널 개수 정리

---

[개발 환경 설정]

​

개발 환경 : Aws / Amazon Web Services

​

 

---

[설명 정리]

​

// --------------------------------------------------------------------------------------
[개발 및 환경]
// --------------------------------------------------------------------------------------

- 인프라 : Aws / Amazon Web Services


- 기술 구분 : Aws / Aws Kinesis Video Streams / WebRTC


- 사전) AWS KVS WebRTC 설명 : 

  >> WebRTC 란 웹, 애플리케이션, 디바이스 간 중간자 없이 오디오나 영상 미디어를 포착하고 실시간 스트림할 뿐 아니라, 임의의 데이터도 교환할 수 있도록 하는 기술입니다

  >> WebRTC 는 간단한 API 를 통해 웹 브라우저, 모바일 애플리케이션 및 커넥티드 디바이스 간에 실시간 통신을 활성화할 수 있습니다

  >> WebRTC 주요 용어 : 

    - SDP (Session Description Protocol) : 오디오/비디오 코덱, 해상도, 포트 등 스트리밍 정보를 담은 텍스트 포맷
    - Offer / Answer	: 통신 연결을 협상하기 위한 SDP 메시지 (초기 연결 설정)
    - ICE (Interactive Connectivity Establishment) : NAT/P2P 환경에서도 연결 가능한 경로(IP, 포트 등)를 찾기 위한 기술
    - Candidate : 가능한 연결 경로 (IP + Port 조합)

  >> WebRTC [ICE] 연결 형태 : 

    - Relayed Address : TURN 서버가 패킷 릴레이를 위해 할당하는 주소
    - Server Reflexive Address : NAT 가 매핑한 클라이언트의 공인망 (Public IP, Port)
    - Local Address : 클라이언트의 사설주소 (Private IP, Port)

  >> WebRTC STUN 및 TURN 서버 설명 : 

    - (같은 와이파이 망) STUN 서버는 HOST 를 거쳐 >> Server Reflexive Address 만을 응답하지만,
      (릴레이서버 사용) TURN 서버는 Relayed Address와 Server Reflexive Address 를 모두 응답한다
    - STUN, TURN 서버를 이용해 SDP Answer IP주소 를 취득 >> RTCPeerConnection Remote 연결 수행

  >> WebRTC SDP 오퍼 생성 (뷰어) 및 응답 (마스터) 스트리밍 플로우 : 

    [Viewer → Signaling Server] -- SDP Offer --> [Master] : 뷰어는 마스터로 스트리밍 오퍼 신호 보낸다
    [Master] -- SDP Answer --> [Viewer] : 마스터는 특정 뷰어의 오퍼 신호 확인 후 응답을 보낸다

    [Viewer] -- ICE Candidate --> [Master] : 스트리밍을 할 수 있는 경로 확인
    [Master] -- ICE Candidate --> [Viewer] : 스트리밍을 할 수 있는 경로 확인

    P2P 연결 성립 → 스트리밍 시작

// --------------------------------------------------------------------------------------






// --------------------------------------------------------------------------------------
[설 명]
// --------------------------------------------------------------------------------------

1. ListSignalingChannelsRequest 는 ChannelInfo 에 관한 정보 요청을 수행하는 API 입니다

  >> ChannelInfoList 반환 예시 JSON : 

  	HTTP/1.1 200
	Content-type: application/json

	{
		"ChannelInfoList": [ 
			{ 
				"ChannelARN": "string",
				"ChannelName": "string",
				"ChannelStatus": "string",
				"ChannelType": "string",
				"CreationTime": number,
				"SingleMasterConfiguration": { 
					"MessageTtlSeconds": number
				},
				"Version": "string"
			}
		],
		"NextToken": "string"
	}


2. ListSignalingChannelsRequest 를 사용할 때 AWS Kinesis Video Streams 에서 반환되는 신호 채널의 최대 개수는 기본값으로 500개 입니다. 


3. ListSignalingChannelsRequest 호출 시 maxResults 파라미터를 설정하면 이 값 (기본 500개) 을 조정할 수 있습니다.

  >> 기본값 : 500

  >> 유효 범위 : 최소 1개 ~ 최대 10,000개 (maxResults는 최대 10,000까지 설정 가능)

  >> 반환 순서는 최근 생성 순이 아님

  >> 단, 실제 반환되는 개수는 조건에 따라 달라질 수 있으며, 결과가 많을 경우 NextToken 을 사용해 페이징 처리해야 합니다.


4. AWS SDK for Android 에서 ListSignalingChannelsRequest 객체 생성 시 maxResults 지정 방법 : 

	ListSignalingChannelsRequest request = new ListSignalingChannelsRequest()
		.withMaxResults(10000); // 최대 개수 지정

// --------------------------------------------------------------------------------------






// --------------------------------------------------------------------------------------
[참고 사이트]
// --------------------------------------------------------------------------------------

[AWS ListSignalingChannels API 설명]

https://docs.aws.amazon.com/ko_kr/kinesisvideostreams/latest/dg/API_ListSignalingChannels.html


[AWS ListSignalingChannelsRequest 설명]

https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc//com/amazonaws/services/kinesisvideo/model/ListSignalingChannelsRequest.html


[자바스크립트 AWS WebRTC 실시간 동영상 재생 수행]

https://blog.naver.com/kkh0977/223170500993?trackingCode=blog_bloghome_searchlist


[Aws Kvs WebRTC 실시간 영상 재생 관련 구성 요소 및 용어 정리]

https://blog.naver.com/kkh0977/223858189791


[Aws KVS WebRTC 채널 생성 및 삭제에 관한 요금 정책 정리]

https://blog.naver.com/kkh0977/223995447546

// --------------------------------------------------------------------------------------

 

---

[참고 사이트]

​

https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc//com/amazonaws/services/kinesisvideo/model/ListSignalingChannelsRequest.html

ListSignalingChannelsRequest (AWS SDK for Java - 1.12.791)

---