Viewer URI Name Space

From Second Life Wiki
Revision as of 21:41, 28 February 2010 by Cerise Sorbet (talk | contribs)
Jump to navigation Jump to search

aka Viewer URL Namespace

aka SLAPP URLs

aka Application SLURL

The SL client supports links of the format secondlife://Region/123/45/67/, which have traditionally specified a region name and x/y/z location. This means "open Second Life and show Region on the world map".

The new URL scheme has 3 slashes, and allows direct control of the user interface and login. For example, secondlife:///app/login

Most secondlife:///app URLs only work from browser instances running inside Second Life because of a denial-of-service attack using secondlife:///app/teleport links to force repeated teleports. SLURLs that work with external browsers include:


secondlife://

  • <region_name> log in to this region or, if logged in, show information and offer teleport
    • /<local_x> optional X position, defaults to 128
      • /<local_y> optional Y position, defaults to 128
        • /<local_z> optional Z position, defaults to 0
  • /app
    • /agent
      • /<agent_id>
        • /about open agent's profile, with 2nd Life tab selected
    • /appearance
        • /show display the sidebar appearance tab, added in 2.0
    • /balance
        • /request request a L$ balance update from the server
    • /chat
      • /<channel> any channel number greater then or equal to 0
        • /<text>
    • /classified
      • /<classified_id>
        • /about open floater describing classified
    • /event
      • /<event_id>
        • /about open floater describing event
    • /group
      • /<group_id>
        • /about open floater describing group
      • /create open the create group dialog, added in 1.20
      • /list
        • /show open the list of groups to which user belongs, added in 1.20
    • /help
      • /<help_query> optional help topic
    • /inventory
      • /<inventory_id>
        • /select
      • /show open the inventory sidebar tab
    • /login log in on launch. External and internal browsers.
      • see below for query parameters, of course, values are URL escaped
    • /objectim
      • /<object_id>
        • ?name=<object_name>
        • &owner=<owner_id>
        • &groupowned=true (add if the object is deeded to a group)
        • &slurl=<region>/<x>/<y>/<z> display an info dialog for the object sending this message
    • /parcel
      • /<parcel_id>
        • /about open floater describing place
    • /region
      • /<region_id>
        • /about information from database about that region? list of parcels? covenant?
    • /search
      • /<category> e.g. places
        • /<search_term> open a search floater with matching results
    • /teleport
      • /<region_name> teleport instantly to this region, no dialog
        • /<local_x> optional X position, defaults to 128
          • /<local_y> optional Y position, defaults to 128
            • /<local_z> optional Z position, defaults to 0
    • /worldmap
      • <region_name>
        • /<local_x> optional X position, defaults to 128
          • /<local_y> optional Y position, defaults to 128
            • /<local_z> optional Z position, defaults to 0

This could be extended to things like:

  • /app/event/<event_id>/subscribe to register for notifications
  • /app/parcel/<parcel_id>/teleport to teleport to a specific location
  • /app/agent/<agent_id>/im to start IM session

Login Query Parameters

first the account first name
last the account last name
session the secure session id
location login location, format TBD, optional