Event Listeners

소개

위젯에서 App으로 데이터를 보낼때 동작 하는 함수들 입니다.

이름	설명
onMessage	위젯에서 App으로 보낸 메시지를 수신 할 때 동작하는 함수입니다.

📚 API 설명 및 예제

onMessage

widget.onMessage.Add(function(player, data: any){});

위젯에서 App으로 메시지를 보내면 callback 함수가 동작합니다.

파라미터

이름	타입	설명
player	Player	player는 위젯을 소유한 플레이어를 가르킴 player 파라미터의 이름은 임의로 변경 가능
data	Object	data는 위젯에서 App으로 보낸 메시지를 가르킴 data 파라미터의 이름은 임의로 변경 가능

예제

x 버튼을 눌러서 위젯창 닫는 기능 만들어보기

15KB

sample_EventListener.zip

archive

// 플레이어가 입장할 때 동작하는 함수
App.onJoinPlayer.Add(function (player) {
	player.tag = {
		widget: null,
	};

	player.tag.widget = player.showWidget("sample.html.html", "top", 600, 500);
	player.tag.widget.onMessage.Add(function (player, msg) {
		// 위젯에서 App으로 'type: close'라는 메시지를 보내면 위젯을 파괴함
		if (msg.type == "close") {
			player.showCenterLabel("위젯이 닫혔습니다.");
			player.tag.widget.destroy();
			player.tag.widget = null;
		}
	});
});

sample.html: 버튼과 스크립트 부분

<i onclick="closeWidget()" class="fa-solid fa-xmark"></i>
<script type="text/javascript">
	// x 버튼을 누르면 호출되는 함수
	function closeWidget() {
		// App으로 메시지를 보냄.
		window.parent.postMessage(
			{
				type: "close",
			},
			"*"
		);
	}
</script>

부록

위젯에서 사용가능한 문법