Module Skype :: Class Contact

Class Contact

source code

     object --+        
              |        
skypekit.Cached --+    
                  |    
    skypekit.Object --+
                      |
                     Contact

Address book entry. Encapsulates methods like GetIdentity, GetAvatar, SendAuthRequest, OpenConversation etc. Single contact can have additional phone numbers attached to it (ASSIGNED_PHONE1 .. ASSIGNED_PHONE3). Note that in the context of a conversation, Contacts are represented by Participant objects. Contact member functions all return a Boolean indicating the success (true) or failure (false) of processing the request itself (transport, runtime availability, and so forth)?not the success or failure of its associated functionality. For example, Contact::IsMemberOf returns true if it was able to make a determination, and its result parameter reflects whether this Contact is a member of the target group. Similarly, Contact::IsMemberOf returns false if it was unable to make a determination, and the value of its result parameter is undefined.

Instance Methods
 
_sk_init_(self, object_id, transport)
actual constructor
source code
 
__str__(self)
str(x)
source code
 
OnPropertyChange(self, property_name)
notifies from a property change
source code
 
GetIdentity(self)
No description available.
source code
 
GetAvatar(self)
Returns Conrtact's avatar image (JPG).
source code
 
GetVerifiedEmail(self)
returns verified-by-Skype e-mail for this contact if exists and verifiable
source code
 
GetVerifiedCompany(self)
returns verified-by-Skype company for this contact if exists and verifiable
source code
 
IsMemberOf(self, group)
Checks whether the contact is member of a contact group given in group reference argument.
source code
 
IsMemberOfHardwiredGroup(self, group_type)
Checks whether the contact is member of a pre-defined contact group given in the TYPE argument (type for this property comes from the ContactGroup class).
source code
 
SetBlocked(self, blocked, abuse=False)
Blocks or unblocks any further incoming communication attempts from this contact.
source code
 
IgnoreAuthRequest(self)
Rejects and removes a pending authorization request from this Contact.
source code
 
GiveDisplayName(self, name)
sets CONTACT_GIVEN_DISPLAYNAME.
source code
 
SetBuddyStatus(self, is_my_buddy, sync_auth=True)
Adds or removes this Contact from the ALL_BUDDIES hardwired group.
source code
 
SendAuthRequest(self, message, extras_bitmask=0)
Sends a contact authorization request to this user.
source code
 
HasAuthorizedMe(self)
the contact has accepted my auth request
source code
 
SetPhoneNumber(self, num, label, number)
Sets the three P_ASSIGNED_PHONEx and P_ASSIGNED_PHONEx_LABEL properties, where x reflects the value of num.
source code
 
OpenConversation(self)
Retrieves a dialog conversation with the Contact.
source code
 
HasCapability(self, capability, query_server=False)
Retrieves a Contact::Capability value.
source code
 
GetCapabilityStatus(self, capability, query_server=False)
Retrieves a Contact::Capability value.
source code
 
RefreshProfile(self)
Refreshes all properties, capabilities, and statuses associated with this Contact from p2p/CBL, and sets P_REFRESHING to true for the duration.
source code
 
mget_profile(self)
get multiple properties from self
source code

Inherited from skypekit.Object: multiget

Inherited from skypekit.Cached: __copy__

Inherited from object: __delattr__, __format__, __getattribute__, __hash__, __init__, __reduce__, __reduce_ex__, __repr__, __setattr__, __sizeof__, __subclasshook__

Static Methods
 
propid(propname)
convert a property name to the enum of the property
source code

Inherited from skypekit.Cached: __new__, sk_exists

Class Variables
  event_handlers = {}
  propid2label = {4: 'skypename', 5: 'fullname', 6: 'pstnnumber'...
  module_id = 2
  TYPE = {0: 'UNRECOGNIZED', 1: 'SKYPE', 2: 'PSTN', 3: 'EMERGENC...
Same as with CAPABILITY, enumerator is used by both Contact and Account objects.
  AUTHLEVEL = {0: 'NONE', 1: 'AUTHORIZED_BY_ME', 2: 'BLOCKED_BY_...
Describes the recognized relational states between a local account and a remote contact.
  AVAILABILITY = {0: 'UNKNOWN', 1: 'OFFLINE', 2: 'ONLINE', 3: 'A...
Describes the superset list of possible Account and Contact online statuses.
  EXTRA_AUTHREQ_FIELDS = {1: 'SEND_VERIFIED_EMAIL', 2: 'SEND_VER...
SEND_VERIFIED_EMAIL - send verified e-mail blob with this auth request
  CAPABILITY = {0: 'CAPABILITY_VOICEMAIL', 1: 'CAPABILITY_SKYPEO...
This enumerator is used by both Contact and Account objects.
  CAPABILITYSTATUS = {0: 'NO_CAPABILITY', 1: 'CAPABILITY_MIXED',...
List of possible states of each of the Contact class CAPABILITY items.
  P_TYPE = 202
  P_SKYPENAME = 4
  P_PSTNNUMBER = 6
  P_FULLNAME = 5
  P_BIRTHDAY = 7
  P_GENDER = 8
  P_LANGUAGES = 9
  P_COUNTRY = 10
  P_PROVINCE = 11
  P_CITY = 12
  P_PHONE_HOME = 13
  P_PHONE_OFFICE = 14
  P_PHONE_MOBILE = 15
  P_EMAILS = 16
  P_HOMEPAGE = 17
  P_ABOUT = 18
  P_AVATAR_IMAGE = 37
  P_MOOD_TEXT = 26
  P_RICH_MOOD_TEXT = 205
  P_TIMEZONE = 27
  P_CAPABILITIES = 36
  P_PROFILE_TIMESTAMP = 19
  P_NROF_AUTHED_BUDDIES = 28
  P_IPCOUNTRY = 29
  P_AVATAR_TIMESTAMP = 182
  P_MOOD_TIMESTAMP = 183
  P_RECEIVED_AUTHREQUEST = 20
  P_AUTHREQ_TIMESTAMP = 25
  P_LASTONLINE_TIMESTAMP = 35
  P_AVAILABILITY = 34
  P_DISPLAYNAME = 21
  P_REFRESHING = 22
  P_GIVEN_AUTHLEVEL = 23
  P_GIVEN_DISPLAYNAME = 33
  P_ASSIGNED_COMMENT = 180
  P_LASTUSED_TIMESTAMP = 39
  P_AUTHREQUEST_COUNT = 41
  P_ASSIGNED_PHONE1 = 184
  P_ASSIGNED_PHONE1_LABEL = 185
  P_ASSIGNED_PHONE2 = 186
  P_ASSIGNED_PHONE2_LABEL = 187
  P_ASSIGNED_PHONE3 = 188
  P_ASSIGNED_PHONE3_LABEL = 189
  P_POPULARITY_ORD = 42

Inherited from skypekit.Object: rwlock

Instance Variables

Inherited from skypekit.Object: properties

Properties
  type
  skypename
defined if it is a SKYPE contact
  pstnnumber
  fullname
  birthday
integer of YYYYMMDD format
  gender
1-male, 2-female
  languages
ISO language code list, space separated
  country
ISO country code
  province
  city
  phone_home
This corresponds to the Account::P_PHONE_HOME property.
  phone_office
This corresponds to the Account::P_PHONE_OFFICE property.
  phone_mobile
This corresponds to the Account::P_PHONE_MOBILE property.
  emails
will be hashed before advertising/querying, space separated
  homepage
  about
arbitrary introductory text
  avatar_image
Contact avatar pictures are in JPG format.
  mood_text
Personal mood message (visible to authorized users only).
  rich_mood_text
XML version of personal mood text
  timezone
24*3600+diff_to_UTC_in_seconds.
  capabilities
binary tag that can be queried via Contact::HasCapability()
  profile_timestamp
UNIX timestamp of last profile change
  nrof_authed_buddies
count of this user's authorized contacts
  ipcountry
ISO country code assigned by the IP
  avatar_timestamp
UNIX timestamp of when current avatar was set
  mood_timestamp
NOT SET FOR CONTACTS.
  received_authrequest
set if the contact is waiting to be authorized.
  authreq_timestamp
timestamp of last received auth-request
  lastonline_timestamp
X timestamp of last successful ping to that user
  availability
Contact::AVAILABILITY
  displayname
always set (assigned by lib by looking at various fields)
  refreshing
true if querying additional information from p2p or server
  given_authlevel
Contact::AUTHLEVEL, change via Contact::GiveAuthlevel()
  given_displayname
change via Contact::GiveDisplayname()
  assigned_comment
change via Contact::AssignComment()
  lastused_timestamp
UNIX timestamp of last outbound session (call, chat, FT, etc)
  authrequest_count
for contacts that have CONTACT_RECEIVED_AUTHREQUEST, how many times in a row they have requested it without positive answer
  assigned_phone1
Office phone no.
  assigned_phone1_label
Value "1" in this property will be translated as "Office" by Skype Windows desktop client, according to UI language settings
  assigned_phone2
Mobile phone no.
  assigned_phone2_label
Value "2" in this property will be translated as "Mobile" by Skype Windows desktop client, according to UI language settings
  assigned_phone3
"Other phone no.
  assigned_phone3_label
Value "3" in this property will be translated as "Other" by Skype Windows desktop client, according to UI language settings
  popularity_ord
Contact's order by presence popularity

Inherited from object: __class__

Method Details

_sk_init_(self, object_id, transport)

source code 

actual constructor

Overrides: skypekit.Object._sk_init_

__str__(self)
(Informal representation operator)

source code 

str(x)

Overrides: object.__str__
(inherited documentation)

GetIdentity(self)

source code 

No description available.

Return values:

  • identity - returns CONTACT_SKYPENAME or CONTACT_PSTNNUMBER value

GetAvatar(self)

source code 

Returns Conrtact's avatar image (JPG).

Return values:

  • present -
    • true: the Contact has a custom avatar image
    • false: the Contact does not have a custom avatar image
  • avatar - The avatar image data (JPG). If present is false, this will be the Skype-assigned default avatar

GetVerifiedEmail(self)

source code 

returns verified-by-Skype e-mail for this contact if exists and verifiable

Return values:

  • email

GetVerifiedCompany(self)

source code 

returns verified-by-Skype company for this contact if exists and verifiable

Return values:

  • company

IsMemberOf(self, group)

source code 

Checks whether the contact is member of a contact group given in group reference argument.

Arguments:

  • group - The target contact group

Return values:

  • result -
    • true: the Contact is a member of the target contact group
    • false: the Contact is not a member of the target contact group

IsMemberOfHardwiredGroup(self, group_type)

source code 

Checks whether the contact is member of a pre-defined contact group given in the TYPE argument (type for this property comes from the ContactGroup class).

Arguments:

  • group_type - The type designator of the target pre-defined contact group. For example, specify this parameter as ContactGroup::TYPE.RECENTLY_CONTACTED_CONTACTS to determine if you've had a recent conversation with this Contact.

Return values:

  • result -
    • true: the Contact is a member of the target contact group
    • false: the Contact is not a member of the target contact group

SetBlocked(self, blocked, abuse=False)

source code 

Blocks or unblocks any further incoming communication attempts from this contact.

Arguments:

  • blocked -
    • true: block this contact
    • false: unblock this contact
  • abuse - Optional parameter to report abuse by this Skype user when blocking this Contact. Note that you can specifiy this parameter as true only when blocking a Contact. Defaults to false if omitted.

GiveDisplayName(self, name)

source code 

sets CONTACT_GIVEN_DISPLAYNAME. clears if size(name)==0

Arguments:

  • name

SetBuddyStatus(self, is_my_buddy, sync_auth=True)

source code 

Adds or removes this Contact from the ALL_BUDDIES hardwired group.

Arguments:

  • is_my_buddy -
    • true: add this contact to the ALL_BUDDIES group
    • false: delete contact from the ALL_BUDDIES group
  • sync_auth - This argument is deprecated and should not be used.

SendAuthRequest(self, message, extras_bitmask=0)

source code 

Sends a contact authorization request to this user.

Arguments:

  • message - Text that typically introduces the requesting user and details the reason for the authorization request. This text will be set as Message::P_BODY_XML property of the notification Message the remote user will receive upon getting the authortization request. While this can be the empty string, it cannot be null.
  • extras_bitmask - Indicates additional information to include with this authorization request:
    • 0 (zero): do not include any additional information
    • SEND_VERIFIED_EMAIL: include the requestor's verified e-mail address
    • SEND_VERIFIED_COMPANY: include verified information regarding the requestor's company
    • SEND_VERIFIED_EMAIL + SEND_VERIFIED_COMPANY: include both e-mail and company information

HasAuthorizedMe(self)

source code 

the contact has accepted my auth request

Return values:

  • result

SetPhoneNumber(self, num, label, number)

source code 

Sets the three P_ASSIGNED_PHONEx and P_ASSIGNED_PHONEx_LABEL properties, where x reflects the value of num.

The Skype Windows desktop client uses the following conventions when interpreting and assigning values to these properties. While your solution can assign arbitrary values to these properties, we strongly recommend using these conventions to ensure interoperability with the Skype Windows desktop client. Keep in mind that the "number" of these property pairs has no relationship to how the Skype Windows client interprets their label property value strings. For example, the Skype Windows client will interpret P_ASSIGNED_PHONE3_LABEL as "Home" if its value is the string "0".

Label strings:

Populate the label properties with string representations of the numbers "0" through "3", rather than descriptive strings like "Home", "Mobile", and so forth. The Skype desktop clients interpret the numeric string values as:

  • "0" (zero) - "Home"
  • "1" (one) - "Office"
  • "2" - "Mobile"
  • "3" - "Other"

Keep in mind that the "number" of a property pair has no relationship to its label string. For example, the Skype Windows client will interpret P_ASSIGNED_PHONE3_LABEL as "Home" if its value is the string "0".

Phone number strings:

The Skype Windows desktop client has distinct conventions for Skype Contacts and PSTN (SkypeOut) Contacts: any or all of the property pairs can be used for Skype Contacts; P_ASSIGNED_PHONE1 cannot be used for PSTN Contacts and P_ASSIGNED_PHONE1_LABEL has special meaning for PSTN Contacts. Specifically, the Skype desktop clients use P_ASSIGNED_PHONE1_LABEL as the label for a PSTN Contact's primary number (regardless of whether it's home, mobile, or office), and use P_PSTNNUMBER to hold the actual number.

Arguments:

  • num - The property pair being set, which must be in the range 0..3
  • label - The label text for the property being set
  • number - The phone number for the property being set

OpenConversation(self)

source code 

Retrieves a dialog conversation with the Contact.

Return values:

  • conversation - Retrieved dialog.

HasCapability(self, capability, query_server=False)

source code 

Retrieves a Contact::Capability value. Sets P_REFRESHING to true while querying from server. This method is functionally the same as Contact::GetCapabilityStatus except that it returns a bool value rather than Contact::CAPABILITYSTATUS

Arguments:

  • capability - The target capability
  • query_server -
    • true: obtains the data from the p2p network/server, and sets P_REFRESHING to true for the duration
    • false: obtains the data from the local client

Return values:

  • result -
    • true: the Contact has the target capability through at least one of the Skype clients they have logged into. Corresponds to CAPABILITY_MIXED and CAPABILITY_EXISTS
    • false: the Contact does not have the target capability. Corresponds to NO_CAPABILITY

GetCapabilityStatus(self, capability, query_server=False)

source code 

Retrieves a Contact::Capability value. Sets P_REFRESHING to true while querying from server.

Arguments:

  • capability - The target capability, see Contact::Capability enumerator.
  • query_server -
    • true: obtains the data from the p2p network/server, and sets P_REFRESHING to true for the duration
    • false: obtains the data from the local client

Return values:

  • status - Status of the target capability.

Class Variable Details

propid2label

Value:
{4: 'skypename',
 5: 'fullname',
 6: 'pstnnumber',
 7: 'birthday',
 8: 'gender',
 9: 'languages',
 10: 'country',
 11: 'province',
...

TYPE

Same as with CAPABILITY, enumerator is used by both Contact and Account objects.

  • UNRECOGNIZED - Contact/account has no pre-identified type. This type is reported by default for SkypeKit clients.
  • SKYPE - Normal Skype contact.
  • PSTN - Normal PSTN contact.
  • EMERGENCY_PSTN - Emergency number (i.e. 911).
  • FREE_PSTN
  • UNDISCLOSED_PSTN - Undisclosed PSTN number.
  • EXTERNAL - This type is currently used by Windows desktop clients for contacts imported from Outlook.
Value:
{0: 'UNRECOGNIZED',
 1: 'SKYPE',
 2: 'PSTN',
 3: 'EMERGENCY_PSTN',
 4: 'FREE_PSTN',
 5: 'UNDISCLOSED_PSTN',
 6: 'EXTERNAL',
 'EMERGENCY_PSTN': 3,
...

AUTHLEVEL

Describes the recognized relational states between a local account and a remote contact.

  • NONE - Authorization request is either ignored or pending. In this state several functionalities may be blocked, depending on settings. For example, accounts may only allow seeing online presence to be viewable or only receive calls from authorized contacts.
  • AUTHORIZED_BY_ME - Contact has been authorized by the local account.
  • BLOCKED_BY_ME - Contact has been blocked by the local account. This prevents incoming calls, chat messages, additional authorization requests etc.
Value:
{0: 'NONE',
 1: 'AUTHORIZED_BY_ME',
 2: 'BLOCKED_BY_ME',
 'AUTHORIZED_BY_ME': 1,
 'BLOCKED_BY_ME': 2,
 'NONE': 0}

AVAILABILITY

Describes the superset list of possible Account and Contact online statuses. In case of Account they apply to local user, in case of Contact they apply to remote contacts.

  • UNKNOWN - Contact online status cannot be determined. This availability state should not normally reach the SkypeKit UI level.
  • PENDINGAUTH - Seeing Contact online status is blocked because authorization between contact and local account has not taken place.
  • BLOCKED - Remote contact has been blocked by local account. This applies to online accounts.
  • BLOCKED_SKYPEOUT - Remote SkypeOut contact has been blocked by local account.
  • SKYPEOUT - Contact does not have an online status because he is a PSTN contact.
  • OFFLINE - Contact appears to be offline.
  • OFFLINE_BUT_VM_ABLE - Contact appears to be offline but has voicemail enabled.
  • OFFLINE_BUT_CF_ABLE - Contact appears to be offline but has enabled call forwarding, so calls may actually get through to him.
  • ONLINE - Contact / Account is online
  • AWAY - Contact / Account is online but away from keyboard. This can be either turned on manually or by automatic timer. In Windows desktop client, the timer can be configured with minute precision.
  • NOT_AVAILABLE - This online status is marked as deprecated. If a remote contact indicates its status as NOT_AVAILABLE, the UI should handle this as equivalent of AWAY status.
  • DO_NOT_DISTURB - Contact / Account is online but does not wish to be disturbed. This status supersedes AWAY status when the account is DO_NOT_DISTURB the AWAY timer should not modify the status.
  • SKYPE_ME - This online status is marked as deprecated. If a remote contact indicates its status as SKYPE_ME, the UI should handle this as equivalent of ONLINE status.
  • INVISIBLE - Account status is set to INVISIBLE. This status in not applicable to remote Contacts. When the remote contact has set his availability to INVISIBLE, he will appear as OFFLINE to others.
  • CONNECTING - only possible for local user/account
  • ONLINE_FROM_MOBILE
  • AWAY_FROM_MOBILE - *_FROM_MOBILE only possible for remote user
  • NOT_AVAILABLE_FROM_MOBILE
  • DO_NOT_DISTURB_FROM_MOBILE
  • SKYPE_ME_FROM_MOBILE
Value:
{0: 'UNKNOWN',
 1: 'OFFLINE',
 2: 'ONLINE',
 3: 'AWAY',
 4: 'NOT_AVAILABLE',
 5: 'DO_NOT_DISTURB',
 6: 'INVISIBLE',
 7: 'SKYPE_ME',
...

EXTRA_AUTHREQ_FIELDS

  • SEND_VERIFIED_EMAIL - send verified e-mail blob with this auth request
  • SEND_VERIFIED_COMPANY - send verified company blob with this auth request
Value:
{1: 'SEND_VERIFIED_EMAIL',
 2: 'SEND_VERIFIED_COMPANY',
 'SEND_VERIFIED_COMPANY': 2,
 'SEND_VERIFIED_EMAIL': 1}

CAPABILITY

This enumerator is used by both Contact and Account objects. Thus the items here can have slightly different meaning, depending on which context you will examine their values. In case of Contact, the values apply to a user - across all the instances that user has logged in with Skype. In case of Account, the capability is that of a local, currently logged in instance of Skype client.

The values that CAPABILITY items can have are also dependant on class context. In context of Contact, a capability can be CAPABILITY_MIXED. Which in case of CAPABILITY_VIDEO, for example, would mean that the remote use has logged in with different clients, some of which support video calls and some of which don't. In context of Account - there are no mixed result. Currently logged in Skype instance either supports video or it doesn't.

  • CAPABILITY_VOICEMAIL - For Account object, this is the same as CAPABILITY_CAN_BE_SENT_VM - it indicates that the currently logged in Skype instance supports voicemails. For Contact objects, it means that their remote system supports sending voicemails - there is no technical method for Skype to detect whether they are capable of receiving voicemails, so the assumption is that they can.
  • CAPABILITY_SKYPEOUT - Indicates that the contact/account has SkypeOut and is thus capable of making PSTN calls.
  • CAPABILITY_SKYPEIN - Indicates that the contact/account has SkypeIn and is thus capable of answering PSTN calls.
  • CAPABILITY_CAN_BE_SENT_VM - For contacts, this is a combination of CAPABILITY_VOICEMAIL for local account (local Skype client supports sending voicemails) and CAPABILITY_VOICEMAIL of the Contact - if the contact supports sending voicemails then hopefully they can also receive them.
  • CAPABILITY_CALL_FORWARD - Indicates that Account/Contact supports call forwarding.
  • CAPABILITY_VIDEO - Indicates that Account/Contact supports call video calls.
  • CAPABILITY_TEXT - In context of Contact, this indicates that the user is noticed running at least one Skype implementation that supports text messaging. Basically, it applies to a user. When applied to Account, the meaning is slightly different. In that case it indicates that currently running Skype implementation supports chat messaging. So, for Account objects, this is a node (rather than user) capability.
  • CAPABILITY_SERVICE_PROVIDER - Indicates that the contact/account is flagged as SkypePrime service provider. This is linked to Account class SERVICE_PROVIDER_INFO property.
  • CAPABILITY_LARGE_CONFERENCE - This is a legacy item, from the old times when conference calls with more than 5 people were limited to SkypePro accounts. In other words, this item is no longer relevant and will likely be removed at some point in future.
  • CAPABILITY_COMMERCIAL_CONTACT
  • CAPABILITY_PSTN_TRANSFER - Indicates that Account/Contact supports call transfers to PSTN numbers.
  • CAPABILITY_TEXT_EVER - Indicates that the user has had his chat capability removed by Skype. Basically, this means that the user is reported as spammer too many times. This applies for both Contact and Account objects - which means your client can check locally, if the currently logged in user has been marked as a spammer.
  • CAPABILITY_VOICE_EVER - Indicates that the user (Account or Contact) has had his voice call capability removed by Skype.
  • CAPABILITY_MOBILE_DEVICE - Indicates that the instance of Skype client Account/Contact is or in Contact's case has at least occasionally been flagged as a mobile device.
  • CAPABILITY_PUBLIC_CONTACT
Value:
{0: 'CAPABILITY_VOICEMAIL',
 1: 'CAPABILITY_SKYPEOUT',
 2: 'CAPABILITY_SKYPEIN',
 3: 'CAPABILITY_CAN_BE_SENT_VM',
 4: 'CAPABILITY_CALL_FORWARD',
 5: 'CAPABILITY_VIDEO',
 6: 'CAPABILITY_TEXT',
 7: 'CAPABILITY_SERVICE_PROVIDER',
...

CAPABILITYSTATUS

List of possible states of each of the Contact class CAPABILITY items.

  • NO_CAPABILITY - Contact does not have the capability
  • CAPABILITY_MIXED - Contact has occasionally logged in with Skype client that supports the capability. For example, a contact may have Skype client on several machines, only some of which have webcam - in which case CAPABILITY_VIDEO would have its value set as CAPABILITY_MIXED.
  • CAPABILITY_EXISTS - Contact has the capability
Value:
{0: 'NO_CAPABILITY',
 1: 'CAPABILITY_MIXED',
 2: 'CAPABILITY_EXISTS',
 'CAPABILITY_EXISTS': 2,
 'CAPABILITY_MIXED': 1,
 'NO_CAPABILITY': 0}

Property Details

type

Get Method:
_sk_get_type(self)

skypename

defined if it is a SKYPE contact

Get Method:
_sk_get_skypename(self) - defined if it is a SKYPE contact

pstnnumber

Get Method:
_sk_get_pstnnumber(self)

fullname

Get Method:
_sk_get_fullname(self)

birthday

integer of YYYYMMDD format

Get Method:
_sk_get_birthday(self) - integer of YYYYMMDD format

gender

1-male, 2-female

Get Method:
_sk_get_gender(self) - 1-male, 2-female

languages

ISO language code list, space separated

Get Method:
_sk_get_languages(self) - ISO language code list, space separated

country

ISO country code

Get Method:
_sk_get_country(self) - ISO country code

province

Get Method:
_sk_get_province(self)

city

Get Method:
_sk_get_city(self)

phone_home

This corresponds to the Account::P_PHONE_HOME property. The value is set by the remote user in Account profile. As Contact property, this is read-only.

Get Method:
_sk_get_phone_home(self) - This corresponds to the Account::P_PHONE_HOME property.

phone_office

This corresponds to the Account::P_PHONE_OFFICE property. The value is set by the remote user in Account profile. As Contact property, this is read-only. If the Contact has not populated his Account profile with sufficient phone numbers, the UI should implement locally adding additional phone numbers to Contact P_ASSIGNED_PHONE1 .. P_ASSIGNED_PHONE3 properties (and corresponding labels). See Contact::SetPhoneNumber method for more information.

Get Method:
_sk_get_phone_office(self) - This corresponds to the Account::P_PHONE_OFFICE property.

phone_mobile

This corresponds to the Account::P_PHONE_MOBILE property. The value is set by the remote user in Account profile. As Contact property, this is read-only.

Get Method:
_sk_get_phone_mobile(self) - This corresponds to the Account::P_PHONE_MOBILE property.

emails

will be hashed before advertising/querying, space separated

Get Method:
_sk_get_emails(self) - will be hashed before advertising/querying, space separated

homepage

Get Method:
_sk_get_homepage(self)

about

arbitrary introductory text

Get Method:
_sk_get_about(self) - arbitrary introductory text

avatar_image

Contact avatar pictures are in JPG format. The original size of avatar pictures are in no more than 96 x 96 pixels in size. However, as they can be smaller, scaling the pictures up too much to fit your UI can lead to distorted images.

Get Method:
_sk_get_avatar_image(self) - Contact avatar pictures are in JPG format.

mood_text

Personal mood message (visible to authorized users only).

Get Method:
_sk_get_mood_text(self) - Personal mood message (visible to authorized users only).

rich_mood_text

XML version of personal mood text

Get Method:
_sk_get_rich_mood_text(self) - XML version of personal mood text

timezone

24*3600+diff_to_UTC_in_seconds. NB! changes with DST

Get Method:
_sk_get_timezone(self) - 24*3600+diff_to_UTC_in_seconds.

capabilities

binary tag that can be queried via Contact::HasCapability()

Get Method:
_sk_get_capabilities(self) - binary tag that can be queried via Contact::HasCapability()

profile_timestamp

UNIX timestamp of last profile change

Get Method:
_sk_get_profile_timestamp(self) - UNIX timestamp of last profile change

nrof_authed_buddies

count of this user's authorized contacts

Get Method:
_sk_get_nrof_authed_buddies(self) - count of this user's authorized contacts

ipcountry

ISO country code assigned by the IP

Get Method:
_sk_get_ipcountry(self) - ISO country code assigned by the IP

avatar_timestamp

UNIX timestamp of when current avatar was set

Get Method:
_sk_get_avatar_timestamp(self) - UNIX timestamp of when current avatar was set

mood_timestamp

NOT SET FOR CONTACTS. For Account object, UNIX timestamp of when current mood was set

Get Method:
_sk_get_mood_timestamp(self) - NOT SET FOR CONTACTS.

received_authrequest

set if the contact is waiting to be authorized. The value contains auth. request text

Get Method:
_sk_get_received_authrequest(self) - set if the contact is waiting to be authorized.

authreq_timestamp

timestamp of last received auth-request

Get Method:
_sk_get_authreq_timestamp(self) - timestamp of last received auth-request

lastonline_timestamp

X timestamp of last successful ping to that user

Get Method:
_sk_get_lastonline_timestamp(self) - X timestamp of last successful ping to that user

availability

Contact::AVAILABILITY

Get Method:
_sk_get_availability(self) - Contact::AVAILABILITY

displayname

always set (assigned by lib by looking at various fields)

Get Method:
_sk_get_displayname(self) - always set (assigned by lib by looking at various fields)

refreshing

true if querying additional information from p2p or server

Get Method:
_sk_get_refreshing(self) - true if querying additional information from p2p or server

given_authlevel

Contact::AUTHLEVEL, change via Contact::GiveAuthlevel()

Get Method:
_sk_get_given_authlevel(self) - Contact::AUTHLEVEL, change via Contact::GiveAuthlevel()

given_displayname

change via Contact::GiveDisplayname()

Get Method:
_sk_get_given_displayname(self) - change via Contact::GiveDisplayname()

assigned_comment

change via Contact::AssignComment()

Get Method:
_sk_get_assigned_comment(self) - change via Contact::AssignComment()

lastused_timestamp

UNIX timestamp of last outbound session (call, chat, FT, etc)

Get Method:
_sk_get_lastused_timestamp(self) - UNIX timestamp of last outbound session (call, chat, FT, etc)

authrequest_count

for contacts that have CONTACT_RECEIVED_AUTHREQUEST, how many times in a row they have requested it without positive answer

Get Method:
_sk_get_authrequest_count(self) - for contacts that have CONTACT_RECEIVED_AUTHREQUEST, how many times in a row they have requested it without positive answer

assigned_phone1

Office phone no. of the contact. This property should NOT be used for SkypeOut contacts

Get Method:
_sk_get_assigned_phone1(self) - Office phone no.

assigned_phone1_label

Value "1" in this property will be translated as "Office" by Skype Windows desktop client, according to UI language settings

Get Method:
_sk_get_assigned_phone1_label(self) - Value "1" in this property will be translated as "Office" by Skype Windows desktop client, according to UI language settings

assigned_phone2

Mobile phone no. of the contact

Get Method:
_sk_get_assigned_phone2(self) - Mobile phone no.

assigned_phone2_label

Value "2" in this property will be translated as "Mobile" by Skype Windows desktop client, according to UI language settings

Get Method:
_sk_get_assigned_phone2_label(self) - Value "2" in this property will be translated as "Mobile" by Skype Windows desktop client, according to UI language settings

assigned_phone3

"Other phone no. of the contact

Get Method:
_sk_get_assigned_phone3(self) - "Other phone no.

assigned_phone3_label

Value "3" in this property will be translated as "Other" by Skype Windows desktop client, according to UI language settings

Get Method:
_sk_get_assigned_phone3_label(self) - Value "3" in this property will be translated as "Other" by Skype Windows desktop client, according to UI language settings

popularity_ord

Contact's order by presence popularity

Get Method:
_sk_get_popularity_ord(self) - Contact's order by presence popularity