WorldNetworkFingerprintError$ ( world )

Parameters

world - a valid world handle returned by LoadWorldAsync

Description

For a ready loaded world, returns the reason its simulation fingerprint could not be computed, such as an unavailable optional model or an unsupported glTF buffer URI. Offline world loading can succeed while the world remains ineligible for a shared session.

Returns an empty string when fingerprinting succeeded, the load is pending, or the world was created with CreateWorld. For a failed world load, inspect WorldLoadError instead. Invalid or freed handles raise a runtime error.

The result is retained with the world and does not retry file reads. Correct the content and load the world again to obtain a new fingerprint.

Requires Extended mode.

See also: WorldNetworkFingerprint, WorldLoadError, WorldReady.

Example

; WorldNetworkFingerprint and WorldNetworkFingerprintError
; Requires Extended mode. Press Escape to exit.

Graphics3D 640,480,0,2
SetBuffer BackBuffer()

world=LoadWorldAsync("../../../samples/worlds/help-marker.world")
While Not WorldReady(world)
    If WorldLoadState(world)=WORLD_LOAD_FAILED Then RuntimeError WorldLoadError(world)
    If KeyDown(1) Then FreeWorld world : End
    Cls
    Text 20,20,"Loading the world and fingerprinting its simulation content..."
    Flip
Wend

; Both values are retained from loading; these queries do not read files.
fingerprint$=WorldNetworkFingerprint(world)
problem$=WorldNetworkFingerprintError(world)

While Not KeyDown(1)
    Cls
    Text 20,20,"WorldNetworkFingerprint$:"
    Text 20,44,Left(fingerprint,32)
    Text 20,64,Mid(fingerprint,33)
    Text 20,104,"WorldNetworkFingerprintError$:"
    If problem="" Then
        Text 20,128,"Empty: this world's simulation content was fingerprinted."
    Else
        For line=0 To 3
            Text 20,128+line*20,Mid(problem,1+line*65,65)
        Next
    EndIf
    Text 20,248,"Matching shared worlds must have the same fingerprint."
    Text 20,280,"Escape: exit"
    Flip
Wend

FreeWorld world
End