From 6a99d9bf65aa5878cb409945ed2bdbdcb916d047 Mon Sep 17 00:00:00 2001
From: chenqiyang <1406175257@qq.com>
Date: 星期五, 02 九月 2022 14:56:40 +0800
Subject: [PATCH] 更新linphone sdk
---
Shared.IOS.HDLLinphoneSDK/Shared.IOS.HDLLinphoneSDK/Library/linphone.framework/Headers/vcard.h | 131 ++++++++++++++++++++-----------------------
1 files changed, 61 insertions(+), 70 deletions(-)
diff --git a/Shared.IOS.HDLLinphoneSDK/Shared.IOS.HDLLinphoneSDK/Library/linphone.framework/Headers/vcard.h b/Shared.IOS.HDLLinphoneSDK/Shared.IOS.HDLLinphoneSDK/Library/linphone.framework/Headers/vcard.h
old mode 100644
new mode 100755
index 6fc1c3d..c61fa4a
--- a/Shared.IOS.HDLLinphoneSDK/Shared.IOS.HDLLinphoneSDK/Library/linphone.framework/Headers/vcard.h
+++ b/Shared.IOS.HDLLinphoneSDK/Shared.IOS.HDLLinphoneSDK/Library/linphone.framework/Headers/vcard.h
@@ -38,213 +38,204 @@
#define LINPHONE_VCARD BELLE_SIP_CAST(object, LinphoneVcard)
/**
- * Creates a #LinphoneVcard object that has a pointer to an empty vCard
- * @return a new #LinphoneVcard object
- * @deprecated Use linphone_factory_create_vcard() instead.
- * @donotwrap
- */
-LINPHONE_DEPRECATED LINPHONE_PUBLIC LinphoneVcard* linphone_vcard_new(void);
-
-/**
- * Deletes a #LinphoneVcard object properly
- * @param[in] vCard the #LinphoneVcard to destroy
- * @deprecated Use linphone_vcard_unref() or belle_sip_object_unref() instead.
- * @donotwrap
- */
-LINPHONE_DEPRECATED LINPHONE_PUBLIC void linphone_vcard_free(LinphoneVcard *vCard);
-
-/**
* Take a ref on a #LinphoneVcard.
- * @param[in] vCard #LinphoneVcard object
+ * @param vCard #LinphoneVcard object @notnil
+ * @return the same #LinphoneVcard object @notnil
*/
LINPHONE_PUBLIC LinphoneVcard *linphone_vcard_ref(LinphoneVcard *vCard);
/**
* Release a #LinphoneVcard.
- * @param[in] vCard #LinphoneVcard object
+ * @param vCard #LinphoneVcard object @notnil
*/
LINPHONE_PUBLIC void linphone_vcard_unref(LinphoneVcard *vCard);
/**
* Clone a #LinphoneVcard.
- * @param[in] vCard #LinphoneVcard object
- * @return a new #LinphoneVcard object
+ * @param vCard #LinphoneVcard object @notnil
+ * @return a new #LinphoneVcard object @notnil
*/
LINPHONE_PUBLIC LinphoneVcard *linphone_vcard_clone(const LinphoneVcard *vCard);
/**
* Returns the vCard4 representation of the LinphoneVcard.
- * @param[in] vCard the #LinphoneVcard
- * @return a const char * that represents the vCard
+ * @param vCard the #LinphoneVcard @notnil
+ * @return a const char * that represents the vCard. @maybenil
*/
LINPHONE_PUBLIC const char* linphone_vcard_as_vcard4_string(LinphoneVcard *vCard);
/**
* Sets the FN attribute of the vCard (which is mandatory).
- * @param[in] vCard the #LinphoneVcard
- * @param[in] name the display name to set for the vCard
+ * @param vCard the #LinphoneVcard @notnil
+ * @param name the display name to set for the vCard @maybenil
*/
LINPHONE_PUBLIC void linphone_vcard_set_full_name(LinphoneVcard *vCard, const char *name);
/**
* Returns the FN attribute of the vCard, or NULL if it isn't set yet.
- * @param[in] vCard the #LinphoneVcard
- * @return the display name of the vCard, or NULL
+ * @param vCard the #LinphoneVcard @notnil
+ * @return the display name of the vCard, or NULL. @maybenil
*/
LINPHONE_PUBLIC const char* linphone_vcard_get_full_name(const LinphoneVcard *vCard);
/**
* Sets the skipFieldValidation property of the vcard
- * @param[in] vCard the #LinphoneVcard
- * @param[in] skip skipFieldValidation property of the vcard
+ * @param vCard the #LinphoneVcard @notnil
+ * @param skip skipFieldValidation property of the vcard
*/
LINPHONE_PUBLIC void linphone_vcard_set_skip_validation(LinphoneVcard *vCard, bool_t skip);
/**
* Returns the skipFieldValidation property of the vcard.
- * @param[in] vCard the #LinphoneVcard
+ * @param vCard the #LinphoneVcard @notnil
* @return the skipFieldValidation property of the vcard
*/
LINPHONE_PUBLIC bool_t linphone_vcard_get_skip_validation(const LinphoneVcard *vCard);
/**
* Sets the family name in the N attribute of the vCard.
- * @param[in] vCard the #LinphoneVcard
- * @param[in] name the family name to set for the vCard
+ * @param vCard the #LinphoneVcard @notnil
+ * @param name the family name to set for the vCard @maybenil
*/
LINPHONE_PUBLIC void linphone_vcard_set_family_name(LinphoneVcard *vCard, const char *name);
/**
* Returns the family name in the N attribute of the vCard, or NULL if it isn't set yet.
- * @param[in] vCard the #LinphoneVcard
- * @return the family name of the vCard, or NULL
+ * @param vCard the #LinphoneVcard @notnil
+ * @return the family name of the vCard, or NULL @maybenil
*/
LINPHONE_PUBLIC const char* linphone_vcard_get_family_name(const LinphoneVcard *vCard);
/**
* Sets the given name in the N attribute of the vCard.
- * @param[in] vCard the #LinphoneVcard
- * @param[in] name the given name to set for the vCard
+ * @param vCard the #LinphoneVcard @notnil
+ * @param name the given name to set for the vCard @maybenil
*/
LINPHONE_PUBLIC void linphone_vcard_set_given_name(LinphoneVcard *vCard, const char *name);
/**
* Returns the given name in the N attribute of the vCard, or NULL if it isn't set yet.
- * @param[in] vCard the #LinphoneVcard
- * @return the given name of the vCard, or NULL
+ * @param vCard the #LinphoneVcard @notnil
+ * @return the given name of the vCard, or NULL @maybenil
*/
LINPHONE_PUBLIC const char* linphone_vcard_get_given_name(const LinphoneVcard *vCard);
/**
* Adds a SIP address in the vCard, using the IMPP property
- * @param[in] vCard the #LinphoneVcard
- * @param[in] sip_address the SIP address to add
+ * @param vCard the #LinphoneVcard @notnil
+ * @param sip_address the SIP address to add @notnil
*/
LINPHONE_PUBLIC void linphone_vcard_add_sip_address(LinphoneVcard *vCard, const char *sip_address);
/**
* Removes a SIP address in the vCard (if it exists), using the IMPP property
- * @param[in] vCard the #LinphoneVcard
- * @param[in] sip_address the SIP address to remove
+ * @param vCard the #LinphoneVcard @notnil
+ * @param sip_address the SIP address to remove @notnil
*/
LINPHONE_PUBLIC void linphone_vcard_remove_sip_address(LinphoneVcard *vCard, const char *sip_address);
/**
* Edits the preferred SIP address in the vCard (or the first one), using the IMPP property
- * @param[in] vCard the #LinphoneVcard
- * @param[in] sip_address the new SIP address
+ * @param vCard the #LinphoneVcard @notnil
+ * @param sip_address the new SIP address @notnil
*/
LINPHONE_PUBLIC void linphone_vcard_edit_main_sip_address(LinphoneVcard *vCard, const char *sip_address);
/**
- * Returns the list of SIP addresses (as LinphoneAddress) in the vCard (all the IMPP attributes that has an URI value starting by "sip:") or NULL
- * @param[in] vCard the #LinphoneVcard
- * @return \bctbx_list{LinphoneAddress}
+ * Returns the list of SIP addresses in the vCard (all the IMPP attributes that has an URI value starting by "sip:") or NULL
+ * @param vCard the #LinphoneVcard @notnil
+ * @return The SIP addresses. \bctbx_list{LinphoneAddress} @maybenil
*/
LINPHONE_PUBLIC const bctbx_list_t* linphone_vcard_get_sip_addresses(LinphoneVcard *vCard);
/**
* Adds a phone number in the vCard, using the TEL property
- * @param[in] vCard the #LinphoneVcard
- * @param[in] phone the phone number to add
+ * @param vCard the #LinphoneVcard @notnil
+ * @param phone the phone number to add @notnil
*/
LINPHONE_PUBLIC void linphone_vcard_add_phone_number(LinphoneVcard *vCard, const char *phone);
/**
* Removes a phone number in the vCard (if it exists), using the TEL property
- * @param[in] vCard the #LinphoneVcard
- * @param[in] phone the phone number to remove
+ * @param vCard the #LinphoneVcard @notnil
+ * @param phone the phone number to remove @notnil
*/
LINPHONE_PUBLIC void linphone_vcard_remove_phone_number(LinphoneVcard *vCard, const char *phone);
/**
- * Returns the list of phone numbers (as string) in the vCard (all the TEL attributes) or NULL
- * @param[in] vCard the #LinphoneVcard
- * @return \bctbx_list{const char *}
+ * Returns the list of phone numbers in the vCard (all the TEL attributes) or NULL
+ * @param vCard the #LinphoneVcard @notnil
+ * @return The phone numbers as string. \bctbx_list{const char *} @maybenil
*/
LINPHONE_PUBLIC bctbx_list_t* linphone_vcard_get_phone_numbers(const LinphoneVcard *vCard);
/**
* Fills the Organization field of the vCard
- * @param[in] vCard the #LinphoneVcard
- * @param[in] organization the Organization
+ * @param vCard the #LinphoneVcard @notnil
+ * @param organization the Organization. @maybenil
*/
LINPHONE_PUBLIC void linphone_vcard_set_organization(LinphoneVcard *vCard, const char *organization);
/**
* Gets the Organization of the vCard
- * @param[in] vCard the #LinphoneVcard
- * @return the Organization of the vCard or NULL
+ * @param vCard the #LinphoneVcard @notnil
+ * @return the Organization of the vCard or NULL. @maybenil
*/
LINPHONE_PUBLIC const char* linphone_vcard_get_organization(const LinphoneVcard *vCard);
/**
+ * Removes the Organization field of the vCard
+ * @param vCard the #LinphoneVcard @notnil
+ */
+LINPHONE_PUBLIC void linphone_vcard_remove_organization(LinphoneVcard *vCard);
+
+/**
* Generates a random unique id for the vCard.
* If is required to be able to synchronize the vCard with a CardDAV server
- * @param[in] vCard the #LinphoneVcard
+ * @param vCard the #LinphoneVcard @notnil
* @return TRUE if operation is successful, otherwise FALSE (for example if it already has an unique ID)
*/
LINPHONE_PUBLIC bool_t linphone_vcard_generate_unique_id(LinphoneVcard *vCard);
/**
* Sets the unique ID of the vCard
- * @param[in] vCard the #LinphoneVcard
- * @param[in] uid the unique id
+ * @param vCard the #LinphoneVcard @notnil
+ * @param uid the unique id @maybenil
*/
LINPHONE_PUBLIC void linphone_vcard_set_uid(LinphoneVcard *vCard, const char *uid);
/**
* Gets the UID of the vCard
- * @param[in] vCard the #LinphoneVcard
- * @return the UID of the vCard, otherwise NULL
+ * @param vCard the #LinphoneVcard @notnil
+ * @return the UID of the vCard, otherwise NULL. @maybenil
*/
LINPHONE_PUBLIC const char* linphone_vcard_get_uid(const LinphoneVcard *vCard);
/**
* Sets the eTAG of the vCard
- * @param[in] vCard the #LinphoneVcard
- * @param[in] etag the eTAG
+ * @param vCard the #LinphoneVcard @notnil
+ * @param etag the eTAG. @maybenil
*/
LINPHONE_PUBLIC void linphone_vcard_set_etag(LinphoneVcard *vCard, const char * etag);
/**
* Gets the eTag of the vCard
- * @param[in] vCard the #LinphoneVcard
- * @return the eTag of the vCard in the CardDAV server, otherwise NULL
+ * @param vCard the #LinphoneVcard @notnil
+ * @return the eTag of the vCard in the CardDAV server, otherwise NULL. @maybenil
*/
LINPHONE_PUBLIC const char* linphone_vcard_get_etag(const LinphoneVcard *vCard);
/**
* Sets the URL of the vCard
- * @param[in] vCard the #LinphoneVcard
- * @param[in] url the URL
+ * @param vCard the #LinphoneVcard @notnil
+ * @param url the URL. @maybenil
*/
LINPHONE_PUBLIC void linphone_vcard_set_url(LinphoneVcard *vCard, const char *url);
/**
* Gets the URL of the vCard
- * @param[in] vCard the #LinphoneVcard
- * @return the URL of the vCard in the CardDAV server, otherwise NULL
+ * @param vCard the #LinphoneVcard @notnil
+ * @return the URL of the vCard in the CardDAV server, otherwise NULL. @maybenil
*/
LINPHONE_PUBLIC const char* linphone_vcard_get_url(const LinphoneVcard *vCard);
--
Gitblit v1.8.0