tweak examples

This commit is contained in:
B. Petersen
2020-07-21 12:49:15 +02:00
parent e66ca5b018
commit e054a49198
2 changed files with 21 additions and 6 deletions

View File

@@ -3291,9 +3291,11 @@ char* dc_msg_get_videochat_url (const dc_msg_t* msg);
/** /**
* Check if the videochat can be handled internally. * Check if the videochat is a "basic webrtc" videochat.
* If "basic webrtc" as of https://github.com/cracker0dks/basicwebrtc is used to initiate the videochat, *
* this is returned by dc_msg_is_basic_videochat(). * Calling this functions only makes sense for messages of type #DC_MSG_VIDEOCHAT_INVITATION,
* in this case, if "basic webrtc" as of https://github.com/cracker0dks/basicwebrtc was used to initiate the videochat,
* dc_msg_is_basic_videochat() returns true.
* "basic webrtc" videochat may be processed natively by the app * "basic webrtc" videochat may be processed natively by the app
* whereas for other urls just the browser is opened. * whereas for other urls just the browser is opened.
* *
@@ -3301,8 +3303,21 @@ char* dc_msg_get_videochat_url (const dc_msg_t* msg);
* To check if a message is a videochat invitation at all, check the message type for #DC_MSG_VIDEOCHAT_INVITATION. * To check if a message is a videochat invitation at all, check the message type for #DC_MSG_VIDEOCHAT_INVITATION.
* *
* @param msg The message object. * @param msg The message object.
* @return 0=message is no videochat invitation or cannot be handled internally * @return 0=message is no "basic webrtc" videochat invitation
* 1=message is a videochat invitation that can be handled internally or by a supported browser. * 1=message is a "basic webrtc" videochat invitation.
*
* Example:
* ~~~
* if (dc_msg_get_viewtype(msg) == DC_MSG_VIDEOCHAT_INVITATION) {
* if (dc_msg_is_basic_videochat(msg)) {
* // videochat invitation that we ship a client for
* } else {
* // use browser for videochat, just open the url
* }
* } else {
* // not a videochat invitation
* }
* ~~~
*/ */
int dc_msg_is_basic_videochat (const dc_msg_t* msg); int dc_msg_is_basic_videochat (const dc_msg_t* msg);

View File

@@ -6,7 +6,7 @@ X-Mailer: Delta Chat Core 1.40.0/CLI
Chat-Version: 1.0 Chat-Version: 1.0
Chat-Content: videochat-invitation Chat-Content: videochat-invitation
Chat-Videochat-Url: https://example.org/p2p/?roomname=6HiduoAn4xN Chat-Videochat-Url: https://example.org/p2p/?roomname=6HiduoAn4xN
To: <tunis3@example> To: <tunis3@example.org>
From: "=?utf-8?q??=" <tunis4@example.org> From: "=?utf-8?q??=" <tunis4@example.org>
You are invited to an videochat, click https://example.org/p2p/?roomname=6HiduoAn4xN to join. You are invited to an videochat, click https://example.org/p2p/?roomname=6HiduoAn4xN to join.