Realms への接続

realms オプションを指定すると、host / port を書かずに Realm に接続できます。ライブラリが Realm のアドレス情報を取得し、自動的に接続します。

権限について

接続に使う認証アカウントは、その Realm の オーナーであるか、招待されている必要があります。

最小のサンプル

const bedrock = require('bedrock-protocol')

const client = bedrock.createClient({
  realms: {
    pickRealm: realms => realms[0] // 参加中/所有中の Realm 配列から 1 つ返す(非同期関数も可)
  }
})

指定方法は 3 種類

プロパティ	説明
realmId	参加する Realm の ID
realmInvite	招待リンク / 招待コード
pickRealm(realms)	アカウントが参加・所有している Realm の配列を受け取り、参加する 1 つを返す関数

// realmId を指定する例
const client = bedrock.createClient({
  realms: { realmId: '1234567' }
})

// 招待コードを使う例
const client2 = bedrock.createClient({
  realms: { realmInvite: 'https://realms.gg/XXXXXXXX' }
})

// 一覧から選ぶ例(名前で検索)
const client3 = bedrock.createClient({
  realms: {
    pickRealm: async realms => realms.find(r => r.name === 'My Realm')
  }
})

動作メモ

• pickRealm は async 関数にできます(ユーザーに選択肢を提示する UI などと相性が良いです)。
• followPort(デフォルト true)により、ping 応答で告知されたポートへ自動的に接続します。
• Realm 接続でもオンラインモードでの認証(Microsoft / Xbox Live)が必要です。オフラインモードでは Realm には参加できません。