Get Started
クイックスタート
3 min
step 1 認証情報の取得 s3を利用するには、まず認証情報(apiキー)を取得する必要があります。apiキーは管理コンソールから発行できます。 step 2 sdkのインストール javascript sdk npm install s3 sdk ios sdk pod 's3sdk', ' > 1 0 0' android sdk implementation 'com example\ s3 sdk 1 0 0' step 3 sdkの初期化 javascript sdk const s3sdk = new s3sdk('your api key'); ios sdk let s3sdk = s3sdk(apikey "your api key") android sdk s3sdk s3sdk = new s3sdk("your api key"); step 4 roomの作成 roomはチャットの単位です。まず初めにroomを作成します。 javascript sdk const room = await s3sdk createroom('roomname'); console log('room created ', room id); ios sdk s3sdk createroom(name "roomname") { result in switch result { case success(let room) print("room created \\(room id)") case failure(let error) print("failed to create room \\(error)") } } android sdk s3sdk createroom("roomname", new s3sdk callback\<room>() { @override public void onsuccess(room room) { log d("s3sdk", "room created " + room getid()); } @override public void onerror(exception e) { log e("s3sdk", "failed to create room", e); } }); step 5 clientの作成 次に、roomに紐づくclientを作成します。clientはユーザーに相当します。 javascript sdk const client = await s3sdk createclient('clientname', room id); console log('client created ', client id); ios sdk s3sdk createclient(roomid room id, name "clientname") { result in switch result { case success(let client) print("client created \\(client id)") case failure(let error) print("failed to create client \\(error)") } } android sdk s3sdk createclient(room getid(), "clientname", new s3sdk callback\<client>() { @override public void onsuccess(client client) { log d("s3sdk", "client created " + client getid()); } @override public void onerror(exception e) { log e("s3sdk", "failed to create client", e); } }); step 6 テキストデータの送信 clientはテキストデータを送信できます。送信方法はbroadcast(全体送信)とunicast(個別送信)の2種類があります。 javascript sdk // broadcast room sendmessage('hello, everyone!'); // unicast client sendmessage('hello, client!', targetclientid); ios sdk // broadcast room sendmessage(message "hello, everyone!") // unicast client sendmessage(message "hello, client!", targetclientid targetclientid) android sdk // broadcast room sendmessage("hello, everyone!"); // unicast client sendmessage("hello, client!", targetclientid); step 7 イベントハンドラの設定 各clientは、roomに対するbroadcastや自身に対するunicastでのテキストデータの送信が行われた場合、イベントハンドラを発火させます。 javascript sdk client onmessage(message => { 	console log('new message ', message); }); ios sdk client onmessage() { message in print("new message \\(message text)") } android sdk client onmessage(new s3sdk messagelistener() { @override public void onmessage(message message) { log d("s3sdk", "new message " + message gettext()); } });