Skip to content
AelionSDK

Check capabilities on the actual device

Probe after opening

Section titled “Probe after opening”

Run the Session capability probe once for the current page environment and loaded Project. It reports API presence and usable backend/config results for codecs, workers, OffscreenCanvas, WebGL2/WebGPU, AudioWorklet, shared-memory isolation, storage, streams, WASM, and color display.

Cache the report for the page/runtime identity, not forever on the user account. Browser updates, headers, permissions, hardware, and power policy can change it.

Preflight every export

Section titled “Preflight every export”

Call session.export.preflightProfile() with the exact Project, profile, dimensions, frame rate, bitrate, channels, color contract, materials, and sink immediately before starting. Generic codec support or a previous job does not prove the current configuration.

Turn issues into choices

Section titled “Turn issues into choices”

Map stable issue codes to explicit options: lower resolution/rate, choose another profile, switch from memory to OPFS, use a supported rendering backend, remove/replace an unsupported Material, or send the job to a remote renderer.

Typical product handling:

  • API/backend unavailable: disable the corresponding mode and explain the fallback.
  • Exact codec config unsupported: keep the button discoverable, then offer compatible profiles.
  • COOP/COEP missing: use the bounded transferable audio path and show the performance impact.
  • OPFS unavailable: enforce a smaller memory limit or use a custom/remote sink.
  • HDR/color contract unsupported: fail closed or require an explicit SDR conversion workflow.

Disable controls only when the current capability report is conclusive and no user input can change it. Re-run checks after source, settings, permission, or output changes.

Software codec capability descriptors

Section titled “Software codec capability descriptors”

CodecFallbackDescriptor, CodecFallbackRegistry and selectCodecAvailability() describe a host-owned software codec capability. They do not execute or route media work. The 1.2 media and export pipelines ship no WASM codec backend and do not invoke registered descriptors.

Use this registry for product-level availability decisions only. If hardware support is absent, either integrate and test a codec backend in the host, select another export profile, or use remote export. CodecFallbackProvider and selectCodecExecution() are deprecated compatibility names; their fallback result means a provider was declared, not that its runtime was wired.