Using the "Platform Info" script interface? [SOLVED]

Solved:

Solution

I updated C3 to the most recent version, and the Platform Info script interface now works as expected.

Problem

Without realizing it, I had been using an outdated version of C3, that predated the addition of the Platform Info script interface.

Cause

It was me all along! My C3 version was out of date as a result of my having left the same C3 Chrome tab open across several days. Without refreshing the tab, the version fell behind. I'd updated the C3 version in an adjacent tab at some point, and didn't realize later on that I then had multiple C3 tabs open that were running different versions.

Original post:

I'm trying to use the "Platform Info" script interface to determine if my project is running in a browser, or in NW.js.

I can't seem to access or interact with the platform info script interface at all.

I assume I'm doing something wrong, but I'm not sure what.

What I tried

I initially just wanted to test out printing the platform info's os value to verify that I could.

1. I created a new empty project.

2. In the layout editor I right clicked to insert a new object, and chose the "Platform Info" object.

So, in the project bar, in the "Object types" folder, there is now an object named "PlatformInfo".

3. In the "Scripts" folder, I double-clicked "main.js" to open it in a tab.

4. In the main.js tab, in the function body for

async function OnBeforeProjectStart(runtime){}

console.log( runtime.platformInfo );
console.log( runtime.objects.PlatformInfo.getFirstInstance() );
console.log( runtime.objects.PlatformInfo.getFirstInstance().os );
console.log( runtime.objects.PlatformInfo );
console.log( runtime.objects.PlatformInfo.os );

// undefined
// [object Object]
// undefined
// [object Object]
// undefined

runtime.platformInfo 
// undefined

runtime.objects.PlatformInfo.getFirstInstance() 
// [object Object]

runtime.objects.PlatformInfo.getFirstInstance().os 
// undefined

runtime.objects.PlatformInfo 
// [object Object]

runtime.objects.PlatformInfo.os 
// undefined

async function OnBeforeProjectStart(runtime){}

Hey R0J0hound, thanks for the reply.

That's what I thought initially, but I've also tried evaluating those same lines in the middle of the tick() function, at which time I'd expect everything to be loaded.

I basically just modified the tick function as follows,

let tickCount = 0; 
function Tick(runtime)
{
	console.log( 'Tick()' );
	if ( tickCount === 0 ){
		
		console.log( runtime.platformInfo );
		console.log( runtime.objects.PlatformInfo.getFirstInstance() );
		console.log( runtime.objects.PlatformInfo.getFirstInstance().os );
		console.log( runtime.objects.PlatformInfo );
		console.log( runtime.objects.PlatformInfo.os );

	} 
	// Code to run every tick
	tickCount ++;
}

// undefined
// [object Object]
// undefined
// [object Object]
// undefined

runtime.objects.PlatformInfo
runtime.objects.PlatformInfo.getFirstInstance()

Thanks Ashley,

When I loaded your example, I got a prompt that the version I was using (r388.2 stable) was too old to open the file (made in r398.2 beta), so I enabled beta releases in the construct settings, and got r398.2 beta.

In r398.2 beta, your cp3 previews correctly on my computer, and in Chrome dev tools, runtime.platformInfo now shows up in the debug view as expected.

It looks like my C3 version was just behind enough to be missing the runtime.platformInfo script interface.

As a test, I created a completely blank project in the newer r398.2 beta, and runtime.platformInfo is present as a property of runtime, even without adding the Platform Info object to the project bar. It shows up between mouse and ticksPerSecond.

I then returned to an instance of the older r388.2 stable, and even when I add the Platform Info object to the project bar, runtime.platformInfo doesn't appear to be present as a property of runtime.

So I think it may have just been a case of my version not being up to date enough.