Web App URL Feedback

[peternewman]

Hi @itota ,

Given you've got a good test setup, we've already seen what the webAppURL looks like with what was presumably an URL type loaded:

From your preset shortcuts in #64 , I'd be curious if you can capture some sample variable contents for any of the other types we support:

companion-module-sony-bravia/src/actions.js

Lines 112 to 115 in 772be29

	{ id: 'activity', label: 'Android Activity' },
	{ id: 'url', label: 'URL' },
	{ id: 'manifest', label: 'Manifest' },
	{ id: 'auid', label: 'Application ID' },

I'm hoping to do something like parseDeviceResourceURI but for this data, but I'm not exactly sure what the data looks like...

companion-module-sony-bravia/src/api.js

Lines 145 to 166 in 772be29

	parseDeviceResourceURI: function (uri) {
	try {
	resourceURI = new URL(uri)
	if (resourceURI.protocol == 'extinput:') {
	let params = resourceURI.searchParams
	return {
	// Seemingly not URL.host!
	kind: resourceURI.pathname,
	port: parseInt(params.get('port')),
	}
	} else {
	return undefined
	}
	} catch (e) {
	// instanceof doesn't seem to work directly
	if (e.name == 'TypeError') {
	return undefined
	} else {
	throw e
	}
	}
	},

[itota]

Here are some samples.

id	value	memo
activity	com.sony.dtv.com.google.android.youtube.tv.com.google.android.apps.youtube.tv.activity.ShellActivity	Full path class name of an Android Activity
url	localapp://webappruntime?url=https%3A%2F%2Fpro-bravia.sony.net%2F	Open URL with the embedded fullscreen browser
manifest	localapp://webappruntime?manifest=http%3A%2F%2F192.168.0.100%3A3000%2F	Open URL specified in the manifest file
auid	localapp://webappruntime?auid=my-app-id-defined-in-manifest	Open URL specified in the manifest file

It looks both manifest and auid indirectly specify a URL.

[itota]

My understanding is that the API assumes two types of applications: Android apps and web apps.
For web apps, it seems possible to know the state, but for Android apps, there appears to be no way to retrieve the state.
And the HDMI input could change independently of the app's state.

[peternewman]

Thanks @itota , I'm a bit confused though, the initial variables screenshot I got from one of your other posts shows a full URL. Likewise the documentation details "url": "http://example.com/":
https://pro-bravia.sony.net/develop/integrate/rest-api/spec/service/appcontrol/v1_0/getWebAppStatus/index.html

But yet the table you put together shows URLs encoded, for example:
localapp://webappruntime?url=https%3A%2F%2Fpro-bravia.sony.net%2F

Are your examples from https://pro-bravia.sony.net/develop/integrate/rest-api/spec/service/appcontrol/v1_0/getApplicationList/index.html rather than getWebAppStatus?

Actually it seems like auid is a HTML5 app (presumably only an installed one), whereas I guess a manifest works on any web-accessible app; URL presumably works on any website and I guess activity is an Android app?

My understanding is that the API assumes two types of applications: Android apps and web apps. For web apps, it seems possible to know the state, but for Android apps, there appears to be no way to retrieve the state. And the HDMI input could change independently of the app's state.

So do we get detailed info back for a manifest and an auid when they're active (and what does it look like/which variable/field is it in)?

I've implemented #68 if you want to take a look which handles parsing of your examples, but I'm now not sure if its hooked into the right data necessarily or possibly even needed/beneficial from a feedback perspective...?

[itota]

I find the specifications in this area somewhat tricky to understand.
My reply also seems to have been a bit lacking in explanation.

Examples of input values and transmitted values

Type on Launch App action	uri value to be sent	User input value on Launch App action	url returned by getWebAppStatus
activity	com.sony.dtv.com.google.android.youtube.tv.com.google.android.apps.youtube.tv.activity.ShellActivity	com.sony.dtv.com.google.android.youtube.tv.com.google.android.apps.youtube.tv.activity.ShellActivity	"active": false
url	localapp://webappruntime?url=https%3A%2F%2Fpro-bravia.sony.net%2F	https://pro-bravia.sony.net/	https://pro-bravia.sony.net/
manifest	localapp://webappruntime?manifest=http%3A%2F%2F192.168.0.100%3A3000%2Fmanifest.json	http://192.168.0.100:3000/manifest.json	https://example.com/myapp
auid	localapp://webappruntime?auid=com.example.app.myapp	com.example.app.myapp	https://example.com/myapp

This manifest.json is expected to be used.

{
  "name": {
    "default": "en_US",
    "en_US": "Sample Application of BRAVIA Professional Display"
  },
  "auid": "com.example.app.myapp",
  "version": "1.0",
  "manifest_version": "1.0",
  "app": {
    "launch": {
      "web_url": "https://example.com/myapp"
    }
  },
  "splash": "splash.jpg",
  "minimum_web_platform_version": "1.0"
}