Protocols/OSCAR/Clients/AIM/URLs: Difference between revisions

From NINA Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 38: Line 38:
| ''Optional''; primary account is default if target linked account is not provided.
| ''Optional''; primary account is default if target linked account is not provided.
|}
|}
==== Examples ====
; aim:goIm?ScreenName=MyNewBuddy&Message=Hello
: The IM window is opened with ''MyNewBuddy'' in "To" field, primary account in "From" field, and the message ''Hello'' set.
; aim:goIm?ScreenName=MyNewBuddy&Message=Hello&TargetBuddyList=LinkedSN123
: The IM window is opened with ''MyNewBuddy'' in "To" field, ''LinkedSN123'' in "From" field, and the message ''Hello'' set.
; aim:goIm?ScreenName=MyNewBuddy&Message=20href3A2Fwww.google.com3c3E
: The IM window is opened with ''MyNewBuddy'' in "To" field, primary account in "From" field, and the message contains and HTML link to Google.





Revision as of 06:56, 24 March 2020

OSCAR Protocol
IntroductionTermsClients
Basic
DatatypesFLAPSNACTLV
UUIDsErrorsTool IDs
Host Interaction
Rate LimitsMigrationMessages
Other Services
ADMINADVERTALERT
BARTBOSBUCPCHAT
CHAT_NAV
Tutorials
Sign OnBARTRendezvous
ICBMLocateBuddies
Foodgroups
OSERVICE (0x0001)
LOCATE (0x0002)
BUDDY (0x0003)
ICBM (0x0004)
ADVERT (0x0005)
INVITE (0x0006)
ADMIN (0x0007)
POPUP (0x0008)
PD (0x0009)
USER_LOOKUP (0x000A)
STATS (0x000B)
TRANSLATE (0x000C)
CHAT_NAV (0x000D)
CHAT (0x000E)
ODIR (0x000F)
BART (0x0010)
FEEDBAG (0x0013)
ICQ (0x0015)
BUCP (0x0017)
ALERT (0x0018)
PLUGIN (0x0022)
UNNAMED_FG_24 (0x0024)
MDIR (0x0025)
ARS (0x044A)


Many AIM clients, both official and third party, allow for special URLs to be used to control the client. URLs can allow web pages and other programs to pass commands to AIM clients.

Introduction

There are several methods for launching AIM URLs:

  1. In Windows, the command can be entered via the Run dialog accessed via the Start Menu or by using the system hot keys Windows + R.
  2. Clicking the URL within AIM, such as in an IM or Profile window.
  3. Clicking an AIM link that's embedded in a web page.

Most AIM URLs are used while the client is online, if it is not, the AIM client will typically prompt you to sign on.

URLs

Depending on the version of the AIM client in use, some URLs may not be available for use. Additionally, parameters are not case sensitive, but their values are.

aim:goIm

This action will invoke a IM window with the screenname of the recipient and the message to send pre-populated.

Parameter Value Note
ScreenName [screenname] Optional; If not set, the "To" field will be empty.
Message [message] Optional; If not set a message must be typed manually.
TargetBuddyList [target link] Optional; primary account is default if target linked account is not provided.

Examples

aim
goIm?ScreenName=MyNewBuddy&Message=Hello
The IM window is opened with MyNewBuddy in "To" field, primary account in "From" field, and the message Hello set.
aim
goIm?ScreenName=MyNewBuddy&Message=Hello&TargetBuddyList=LinkedSN123
The IM window is opened with MyNewBuddy in "To" field, LinkedSN123 in "From" field, and the message Hello set.
aim
goIm?ScreenName=MyNewBuddy&Message=20href3A2Fwww.google.com3c3E
The IM window is opened with MyNewBuddy in "To" field, primary account in "From" field, and the message contains and HTML link to Google.