<doc>
	<legacy_id></legacy_id>
	<name>mobileGetDeviceToken</name>
	<type>function</type>

	<syntax>
		<example>mobileGetDeviceToken()</example>
	</syntax>

	<synonyms>
		<synonym>iphoneGetDeviceToken</synonym>
	</synonyms>

	<summary>Returns the Device Token used for Push Notification.</summary>

	<examples>
<example><p>on pushNotificationRegistered</p><p>   get mobileGetDeviceToken()</p><p>end pushNotificationRegistered</p></example>
	</examples>

	<history>
		<introduced version="5.5">Added</introduced>
		<deprecated version=""></deprecated>
		<removed version=""></removed>
		
		<experimental version=""></experimental>
		<nonexperimental version=""></nonexperimental>
	</history>

	<objects>
	</objects>

	<platforms>
		<ios/>
		<android/>
	</platforms>

	<classes>
		<mobile/>
	</classes>

	<security>
	</security>


	<classification>
	</classification>

	<references>
		<message tag="pushNotificationReceived">pushNotificationReceived Message</message>
		<message tag="pushNotificationRegistered">pushNotificationRegistered Message</message>
		<message tag="pushNotificationRegistrationError">pushNotificationRegistrationError Message</message>
	</references>

	<description>
	<overview>Use the <b>mobileGetDeviceToken</b> function to return the Device Token that is used by the Push Notification Server to identify to which device to send a notification.</overview>

		<parameters>
		</parameters>

	<value>The <b>mobileGetDeviceToken</b> function returns a base 64 encoded representation of 32 byte of binary data that makes up the Device Token.</value>
	<comments>LiveCode registers for push notifications with the operating system when your application starts. The operating system sends a callback message <message tag="pushNotificationRegistered">pushNotificationRegistered</message> to your application once registration is complete. <p></p><p></p><important>The <b>mobileGetDeviceToken</b> function returns empty until registration for push notifications with the operating system is complete. </important><p></p><p>As a result, the <b>mobileGetDeviceToken</b> function should be called when you handle the <message tag="pushNotificationRegistered">pushNotificationRegistered message</message>. </p></comments>
	</description>
</doc>