What are legal values for the :name field passed to createSession?

The createSession method of Toybox.ActivityRecording requires that the provided parameter map contain a :name entry. There isn't really any mention of what values are expected, allowed, or what the data is used for.

It seems that the information is important since it is documented as required, but given the lack of information around it, I'm under the impression that any string would be legal/acceptable.

Travis

Brandon.ConnectIQ over 10 years ago

Hmm, yeah. I think we should update the documentation to be more explicit, because while I don't know of any limit, there must be one.

Former Member over 10 years ago

This is "global" problem. Manual need to be update.

PersistedLocations http://developer.garmin.com/downloads/connect-iq/monkey-c/doc/Toybox/PersistedLocations.html

options (Dictionary) ???? I try use :name, but other? icon, type, group?

tonny.madsen over 10 years ago

This is "global" problem. Manual need to be update.

+1

Seriously!

Former Member over 10 years ago

The :name parameter for create session is a String as indicated by the documentation. There is no limitation at the ConnectIQ level for the length of that string, but there is a limitation when the name is added to the FIT file. If the String provided to ConnectIQ is too long, it will get truncated when it is added to the file. At this time the FIT protocol does not match exactly across all of our products. The current character limit is 16 on the VivoActive and is 24 on FR920 and Fenix 3 (and Epix assuming nothing changes between now and release).

Regarding PersistedLocations:
The only option documented is :name because that is the only option. That option is a String. The documentation says that the option is a "Hash" which is incorrect. We will get that documentation issue corrected.