OpenSim 0.6 IClientAPI

From OpenSimulator

(Difference between revisions)
Jump to: navigation, search
(Porting Guide)
(Porting Guide)
Line 2: Line 2:
 
This page is under construction.
 
This page is under construction.
 
=Porting Guide=
 
=Porting Guide=
 +
==OnNewClient vs OnClientConnect==
 +
* OnNewClient is depreciated, please use OnClientConnect instead.
 +
** Rationale: OnNewClient passes IClientAPI in it's parameter, IClientAPI is being depreciated.
 +
** IClientAPI Changes: IClientCore may not contain all the interfaces you want just yet, but if it does (see the list below for what's been ported so far), you should switch to OnClientConnect and then use IClientCore.[Try]Get<IClientInterface>().Method() instead of IClientAPI.Method();
 
==Instant Message==
 
==Instant Message==
 
* Dropping fromAgentSession from SendInstantMessage (both overloaded versions)
 
* Dropping fromAgentSession from SendInstantMessage (both overloaded versions)

Revision as of 10:43, 8 November 2008

This page is under construction.

Contents

Porting Guide

OnNewClient vs OnClientConnect

  • OnNewClient is depreciated, please use OnClientConnect instead.
    • Rationale: OnNewClient passes IClientAPI in it's parameter, IClientAPI is being depreciated.
    • IClientAPI Changes: IClientCore may not contain all the interfaces you want just yet, but if it does (see the list below for what's been ported so far), you should switch to OnClientConnect and then use IClientCore.[Try]Get<IClientInterface>().Method() instead of IClientAPI.Method();

Instant Message

  • Dropping fromAgentSession from SendInstantMessage (both overloaded versions)
    • Rationale: Session ID is both linden specific, and something that shouldnt be transmitted to users anyway (security).
    • IClientAPI changes: Insert this parameter into your packets manually if you need it, LLClientView.cs contains a reference to sessionID already. Be advised that this represents a security risk (giving the users one of the two shared secrets).
  • Dropping imSessionID from SendInstantMessage (both overloaded versions)
    • Rationale: IM Session ID's are unique to SL and we just multiplex the two users ID's to form this so it's static anyway.
    • IClientAPI changes: Multiplex the ID inside your own implementations vs relying on the module to do it for you.

Bluebox

  • Dropping sessionID from SendBlueBoxMessage
    • Rationale: Session ID is both linden specific, and something that shouldnt be transmitted to users anyway (security).
    • IClientAPI changes: Insert this parameter into your packets manually if you need it, LLClientView.cs contains a reference to sessionID already. Be advised that this represents a security risk (giving the users one of the two shared secrets).
Personal tools
General
About This Wiki