マルチプレイでの一時的な部屋のアクセス制限

4 分

ロック、アンロック機能を使用して、希望のタイミングで部屋へのアクセスを制限または許可できます。

📘 次のガイドを参照してください。 [ZEPETO.Multiplay(Server) API]

ロック

ロック機能は部屋へのアクセスを制限する機能です。

await this.lock();

アンロック

アンロック機能は部屋へのアクセスを許可する機能です。ただし、現在接続されている人数が部屋に許可されている最大人数と同じ場合、部屋はアンロックできません。

await this.unlock();

例

以下は、ロックとアンロック機能を使用したサンプルコードです。

import { Sandbox, SandboxOptions, SandboxPlayer } from 'ZEPETO.Multiplay';

export default class extends Sandbox {

    onCreate(options: SandboxOptions) {

    }

    async onJoin(client: SandboxPlayer) {
        try {
            if (this.clients.length > 8) {
                await this.lock();
            }
        } catch(e) {
            console.error(e);
        }
    }

    async onLeave(client: SandboxPlayer, consented?: boolean){
        try {
            if (this.clients.length <= 8) {
                await this.unlock();
            }
        } catch(e) {
            console.error(e);
        }
    }
}

👍 ロックとプライベート機能の違い

ロックされたマルチプレイヤールームはZEPETOのルームリストに表示されず、招待によっても入室できません。
プライベートマルチプレイヤールームはZEPETOのルームリストに表示されませんが、招待は受け付けられます。