Cross-Page Navigation (Messenger Connect)

Ff750919.note(en-us,MSDN.10).gifNote:
Current information about Live Connect is now available in the Windows Live Developer Center. The information in the following sections is provided for legacy purposes only.

Starting with the release of the Windows Live Messenger Library version 3.0, the Messenger Library and Messenger UI Controls support cross-page navigation. Windows Live Messenger Connect maintains a user's Messenger session across pages of the same site. The session information includes contact information and a user's instant messaging (IM) conversations.

The Messenger Connect UI Controls support cross-page navigation. Applications can take advantage of the cross-page support without any special steps.

Messenger Library applications should follow the guidelines in this section to handle cross-page navigation. Each Messenger Library application can implement the same logic on each page of the application.

  1. An application should authenticate and sign in a user in the same way on every page by initializing an Identity object and calling Microsoft.Live.Messenger.User.signIn with the Identity object.
    Notes   
    • The application can behave the same way on every page visit.
    • After the initial SignIn call on the first page that is visited by the user, subsequent SignIn calls on subsequent pages take place more quickly because the user is already signed in.
  2. An application initializes its contact list UI by listening for contact property updates after the sign-in process is completed. The application logic is the same whether it is the first page or a subsequent page.
  3. An application should reference the conversation collection to check for existing conversations and to initialize the conversation UI accordingly. The application should check the message history of each existing conversation and initialize the message history in each conversation UI object.
    Note   The Messenger Library API adds a Reloaded property to the Conversation and Message objects. The Reloaded property is true if the conversation or message existed on a previous page.

Windows Live Messenger Connect fully supports cross-page navigation in the following browsers:

  • Microsoft Internet Explorer 6, Windows Internet Explorer 7, and Internet Explorer 8
  • Mozilla Firefox 3.0, 3.5, and 3.6
  • Safari version 4.0
  • Google Chrome versions 4.0 and 5.0
    In Google Chrome, cross-page navigation is available only when Adobe Flash Player or Google Gears is installed.
  • Opera version 10.5

Cross-page navigation uses the local storage that is available in the browser or in a browser plug-in. If a user has numerous contacts or long IM conversations, Windows Live Messenger Connect may remove older information. For example, Windows Live Messenger Connect can remove the earliest IM conversations as a user moves between pages.

Show: