Problem code 'asset-degraded' ​

Contract 2.0.0 · package sha256 a857eca95b35921109faf997094bb4192f12527d9d0fcd4be7e97f06425bad6e · generated from configurator-runtime.d.ts, tables/problems.json and services/onsite-scripter/scripts/contract-docs-what-to-do.json by services/onsite-scripter/scripts/build-contract-docs.mjs; edit the source, not this file.

A member of ProblemCode · stable · since 2.0.0

A preferred asset failed to fetch, decrypt or parse and a fallback was drawn instead: a .holo's plain twin (url the .holo, spec section 8.5), or glbUrl after optGlbUrl failed (url the optGlbUrl, spec section 6.4).

What to do ​

Nothing failed for the shopper: a fallback (IModelNode.plainGlbUrl, plainOptGlbUrl, or glbUrl after optGlbUrl) is drawn. Fix the preferred asset at problem.url where your scene model's URLs come from; the page needs no code change.

session.on('problem', ({ problem: p }) => { if (p.code === 'asset-degraded') console.warn(p.url); }, { signal });

Where the declaration names it ​

• IModelNode.optGlbUrl: If it fails to fetch, decrypt or parse, after its own .holo → plainOptGlbUrl fallback, the runtime tries glbUrl once, with its .holo → plainGlbUrl fallback, and records 'asset-degraded' with url this URL; only when that fails too is the node unloaded, with 'asset-failed' naming the last URL tried.
• IModelNode.plainGlbUrl: Input-only: the public twin the runtime draws when the .holo fails to fetch, decrypt or parse ('asset-degraded').
• Problem.asset: For 'asset-failed' and 'asset-degraded': what failed.
• testing.FakeSessionOptions.models: An entry whose load.fail is set fails as that URL's fetch, decrypt or key would and the chain goes on: a later entry that loads records 'asset-degraded' (url the first URL that failed); none records 'asset-failed' (url the last URL tried).

The set is open: handle a code you don't know ('other').

Recorded by ​

• the table row failure-matrix/cases/holo-fails-plain-twin (tables/failure-matrix.json)
• the table row failure-matrix/cases/opt-glb-fails (tables/failure-matrix.json)
• the table row hold/cases/case-2 (tables/hold.json)