Yospace Support
SmartPhone Emulator Web Site Edition FAQs
How do I get the applet on my site? Is there a getting started guide?
We have produced a step-by-step getting started guide to people new to Yospace.
I can't get it to work. Can I get help?
Of course! Email support is included with the registration charge. However we would greatly appreciate you reading our Frequently Asked Questions as you may be experiencing a common problem that can be easily fixed. We ask you to please read the FAQs carefully before emailing support@yospace.com -- all emails to support should contain the email address you registered with, with the exact version number and name of the product with which you are experiencing difficulties. Often it's also essential to know what browser or platform you are using.
Does the applet work on the Macintosh?
Yes. However you should make sure that your Macintosh Runtime for Java (MRJ) is up to date. We cannot provide support to Macintosh users running an MRJ earlier than 2.2, although it is quite possible that the software will run on earlier versions. Download the latest MRJ from Apple at http://www.apple.com/java. The applet will not work with Netscape Navigator 4.x for Macintosh.
I have put the HTML into my Web page and it displays "Not Licensed". What's wrong?
There are several reasons as to why this might be the case:
The HTML page that contains the applet on your site does not exactly match the Web page that you registered with. For example, if the exact URL of the page that contains the applet reference is http://www.binky.com/applet.html and you registered with http://www.binky.com then the applet will not work.
If, given the same actual URL, you had registered with http://test.binky.com/applet.html where test.binky.com and www.binky.com are the same physical machine, the applet will still not work.
Furthermore, if you registered with http://www.binky.com/index.html where index.html is your "default" filename and you access the page (as you would expect) as http://www.binky.com then the applet will not work. It will work if you reference the page with the URL with which you registered, even though these two URLs reference the same file.
You have not specified a valid or correct start point using the applet parameter wml-homepage. You must make sure that the start point is a valid absolute URL. It must start with http:// and specify a publicly accessible service. If the URL is a location (i.e. a directory) then you must end the URL with no trailing forward slash (/).
Why does the emulator display "Page cannot be displayed" even though I have put the HTML into my Web page?
Your WML page might be invalid. Unlike the many HTML-based WAP browsers you might find on the Web, our server behaves like a strict WAP Gateway so it will not let through a WML page that may not work in a real handset. It is possible to find out the reason for an error by viewing the Java console which is integrated in your browser - see the answers below on how to do this. A good sanity check is to point the applet at http://wap.yospace.com/ which should always work, provided you have registered with the correct URL from which the applet is loaded.
My page works in another WAP Emulator but not in yours! Is there a bug in your emulator?
Our servers carry out the encoding of the WML pages that are delivered into the applet. They adhere strictly to the WAP standards, which means that if you have done something non-standard in your pages it will be rejected (as it might be rejected by a real WAP Gateway/handset). There are several web-based WAP "Emulators" available on the Web which are very tolerant to mistakes in your WML pages -- this can be misleading because your pages are unlikely to work across the many different combinations of handset and WAP Gateway that you customers or visitors may be using.
To find out more information on why the applet failed to render a page, you should view the Java console in your browser -- the last message in this log is the cause of the page not rendering. If you still believe that your WML is okay, then please report this as a possible bug to support@yospace.com. Please include the WML page (or URL to it) and any other information that might be useful, including the last message in the Java Console window.
In our experience, the problem almost always turns out to be an error in the WML that some other SDKs or emulators allow because their implementation of WML is not as rigorous as it should be. Remember that you can only be confident your service will render on all WAP devices if your WML adheres to the WML standard.
How can I view errors generated by the applet?
If you open the Java Console, you will see any messages generated by the emulator applet. Netscape Navigator users should choose Communicator | Tools | Java Console. Internet Explorer uses may need to enable the Java Console option if they haven't done so already. To do this, go to Tools | Internet Options and select the "Advanced" tab in this dialogue. Scroll down the list of settings until you reach the Java section and the first option should be "View Java Console (requires Restart)". Ensure this option is checked, click OK on the dialog and close all instances of Internet Explorer and relaunch it. You should then be able to access the Java Console from the View menu.
When I try to access my WML documents through my own Web server I get an "Unknown File Content" error. What have I done wrong?
A common cause of this error is that your Web server is not returning the correct MIME type when returning the WML document. The MIME type tells the emulator what type of content is being returned and if this is not set correctly the emulator will ignore the content being sent to it. WML files must be sent with a MIME type of text/vnd.wap.wml, bitmap images (WBMPs) must be sent with a MIME type of image/vnd.wap.wbmp.
When the applet loads, I get the error "No Response Received".
There may be several reasons why this occurs:
The server on which the desired content lies is either down or our server cannot reach it. In the declaration at the start of your WML document, you have specified a local URI from which the DTD is fetched. If this line specifies a URL that cannot be fetched by our server (such as a local reference) then our server will be unable to parse and send on the WML page to the applet. If in doubt, ensure that this line is as follows:
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN" "http://www.wapforum.org/DTD/wml_1.1.xml">
The pages are appearing without any graphics. What's wrong?
This is most likely a MIME type configuration problem, please read the question regarding MIME type configuration.
How do I configure my server to send the correct MIME types?
We suggest that you read the manual that came with your Web server. Sorry, but we can't be more helpful in this respect because the details of server adminstration vary widely over different platforms.
Why do the graphics on my page appear to be corrupt?
This may be because you transferred the images to your server using ASCII mode FTP. If you think this might be case, transfer the files again with BINARY mode FTP.
I can't type into the text boxes on the Nokia 7110 emulation.
Make sure that you focus the text box and then click the rollerwheel to go into edit mode. Inside the text box you will be able to use the keyboard, rollerwheel or keypad (if displayed) to enter text. This text edit behaviour is not a bug, it is the way the Nokia 7110 interface works.
When my application issues a HTTP redirect directive the Emulator fails. Why?
This may be because your redirects are relative rather than absolute. Relative URIs in redirects are illegal, however typically tolerated by Web browsers.
I keep noticing that variables are not being rendered correctly. What's wrong?
We recommend that you always explicitly use parens around variables $(x) even when you don't need them. This behaviour ensures better compatibility and does not adversely affect the size of the encoded deck.
Does the emulator support UTF-8 encoding?
Yes, the encoder understands UTF-8 encoding. However, currently the fonts used by the emulator only support Latin-1 characters.
How can I load a URL into the emulator from JavaScript?
You can use JavaScript LiveConnect (a bridge between Java and JavaScript) to set the current URL in the emulator. You can use this facility to create your own set of bookmarks on the page containing the emulator. You will only be allowed to load into the emulator URLs that you have registered for.
If the applet is named spe (which it should be if you have copied the code we give you) then you can make the emulator load a URL by using the following JavaScript:
document.spe.go("http://www.wherever.com/");
This example sends the emulator to http://www.wherever.com/, please note the trailing slash at the end of this URL. For more information on acceptable URLs, please go to this question.
Can I host the servlet myself?
Yes. Hosting the emulator yourself provides enhanced security, control and logging facilities. Please contact sales@yospace.com for more information.
My WML has strange non-printable characters (little squares) in it. Where did they come from?
The most likely cause is that you have transferred your file between a Unix and a Windows environment. Make sure that you choose "ASCII" rather than "Binary" mode when you transfer files. This is an option on most ftp or file transfer programs. Always send your WML files as text files.