メインコンテンツまでスキップ

JSONデータの読み込み

このプロジェクト で、JSON データを二つの方法で読み込む方法を紹介します。一つ目はプロジェクト内のアセットから直接、二つ目はリモートサーバーから HTTP で読み込みます。

アセットから JSON を読み込む​


/**
* @attribute
* @title Character Data
* @type {Asset}
* @resource json
*/
characterData = null;

parseCharacterData(data) {
const names = [];

// JSON アセットからキャラクターデータを読み取り名前のリストを返す
const characters = data.characters;
for (let character of characters) {
names.push(character.firstName + ' ' + character.lastName);
}

return names;
}

// ...

// プロジェクトアセットから JSON データを取得
const characterData = this.characterData.resource;

// JSON データをパース
const names = this.parseCharacterData(characterData);

上記のコードでは、プロジェクト内のアセットから JSON データを読み込むために、スクリプト属性のtypeを 'asset' にするか asset registry からアセットを取得し、resource プロパティにアクセスすれば良いことがわかります。json のアセットに対して resource をアクセスすることで、JSON データは既に Javascript オブジェクトにパースされていることに注目してください。

Javascript オブジェクトを取得したら、通常通りデータにアクセスすることができます。例えば、parseCharacterData メソッドでプロパティをループすることができます。

リモートサーバーから JSON を読み込む​

async function loadJsonFromRemote(url, callback) {
const res = await fetch(url);
const json = await res.json();
callback(json);
}

// ...

// リモートサーバーから JSON を取得
loadJsonFromRemote("https://api.github.com/", (data) => {
// リモートサーバーからの JSON データを表示
el = document.querySelector("#xhr-json");
el.textContent = JSON.stringify(data, null, 4);
});

このコードでは、XMLHttpRequestオブジェクト(標準のWebブラウザAPIの一部)を使用して、URLからJSONデータをリクエストしています。この場合、GitHub APIを使用しています。

"load"イベントを受け取った後、JSON.parseを使用してJSONデータを解析します(これも標準のWebブラウザAPIの一部です)。そして、データをcallback関数を介して返します。

loadJsonFromRemote の呼び出しは、非同期であることに注意してください。

以下は完全なコードリストです。

import { Script, createStyle } from 'playcanvas';

export class Game extends Script {
static scriptName = "game";

/**
* @attribute
* @title Display
* @type {Asset}
* @resource html
*/
display = null;

/**
* @attribute
* @title Style
* @type {Asset}
* @resource css
*/
style = null;

/**
* @attribute
* @title Character Data
* @type {Asset}
* @resource json
*/
characterData = null;

// エンティティごとに一度だけ呼ばれる初期化コード
initialize() {
this.initDisplay();

// プロジェクトアセットから JSON データを取得
const characterData = this.characterData.resource;

// JSON データをパース
const names = this.parseCharacterData(characterData);

// キャラクターの名前を表示
let el = document.querySelector("#character-name");
if (el) el.textContent = names.join(", ");

// JSON アセットから JSON データを表示
el = document.querySelector("#asset-json");
if (el) el.textContent = JSON.stringify(characterData, null, 4);

// リモートサーバーから JSON データを取得
this.loadJsonFromRemote("https://api.github.com/", (data) => {
// リモートサーバーからの JSON データを表示
el = document.querySelector("#xhr-json");
if (el) el.textContent = JSON.stringify(data, null, 4);
});
}

initDisplay() {
const el = createStyle(this.style.resource);
document.head.appendChild(el);

const div = document.createElement("div");
div.setAttribute("id", "container");
div.innerHTML = this.display.resource;
document.body.appendChild(div);
}

parseCharacterData(data) {
const names = [];

// JSON アセットからキャラクターデータを読み取り名前のリストを返す
const characters = data.characters;
for (let character of characters) {
names.push(character.firstName + ' ' + character.lastName);
}

return names;
}

loadJsonFromRemote(url, callback) {
const xhr = new XMLHttpRequest();
xhr.addEventListener("load", function() {
callback(JSON.parse(this.responseText));
});
xhr.open("GET", url);
xhr.send();
}
}

このプロジェクト からお試しください。