mmr_context_parameters()

Set context parameters.

Synopsis:

#include <mm/renderer/renderer.h>
 
int mmr_context_parameters(mmr_context_t *ctxt,
                           strm_dict_t *parms)

Since:

BlackBerry 10.0.0

Arguments:

ctxt

A context handle.

parms

A dictionary containing the context parameters to set. Any previous parameters are overridden. Do not use or destroy the dictionary after passing it to this function, even if the call fails.

Library:

libmmrndclient (For the qcc command, use the -l mrndclient option to link against this library)

Description:

Set parameters associated with the specified context. BlackBerry 10 OS supports the following parameter:

updateinterval

Allows an application to request a particular frequency in status updates from mm-renderer. How accurately this delivery reflects the updateinterval setting depends on the plugin handling the media flow. Currently, this parameter is supported only for the MMF audio/video player routing plugin. The default update interval is 1000 ms, but your client code should dynamically adjust this parameter based on the application's state, such as fullscreen versus minimized versus when the screen is off.

BlackBerry 10 supports the following HTTP input parameters that map to libcurl options:

  • OPT_CONNECTTIMEOUT_MS
  • OPT_LOW_SPEED_LIMIT
  • OPT_LOW_SPEED_TIME
  • OPT_USERAGENT
  • OPT_USERNAME
  • OPT_PASSWORD
  • OPT_PROXYUSERNAME
  • OPT_PROXYPASSWORD
  • OPT_COOKIE
  • OPT_COOKIEFILE
  • OPT_COOKIEJAR
  • OPT_COOKIESESSION
  • OPT_CAINFO
  • OPT_CAPATH
  • OPT_SSL_VERIFYPEER
  • OPT_SSL_VERIFYHOST
  • OPT_PROXY
  • OPT_NOPROXY
  • OPT_HTTPPROXYTUNNEL
  • OPT_PROXYPORT
  • OPT_PROXYTYPE
  • OPT_PROXYAUTH
  • OPT_HTTPAUTH
  • OPT_HTTPHEADER
  • OPT_DNSCACHETIMEOUT

Blackberry 10 OS supports the following parameters that map to socket options (see the getsockopt() function in the C Library Reference for more information):

  • OPT_SO_RCVBUF
  • OPT_SO_SNDBUF

Returns:

Zero on success, -1 on failure (use mmr_error_info()).

Last modified: 2014-09-30



Got questions about leaving a comment? Get answers from our Disqus FAQ.

comments powered by Disqus