Create the connector object

How to create the connector object to fetch server configuration information.

阅读时间2 分钟

最后更新于 8 个月前

Use a connector object after initialization to fetch server configuration information necessary for your game to login and use Vivox. The connector object is usually only called once per application startup before the first sign in.

To create the connector object, use the

vx_req_connector_create

request structure and the

vx_req_connector_create_create()

function. This is typically the first request issued after

vx_initialize3()

注意

There can only be one active connector object at a time.

When the Vivox SDK processes the

vx_req_connector_create

request, it contacts the Vivox network and downloads configuration information to the client that's relevant to your game's communications infrastructure. This is a one-time HTTP request. The configuration information is loaded into memory before the sign in operation.

If the game's connection is lost, you don't need to issue

vx_req_connector_create

a second time because the information is already in memory. Simply proceed to re-sign in to the game.

The connector object doesn't hold open any ports, use bandwidth, network resources, or CPU for heartbeats, and only requires a small amount of memory to hold the configuration.

The following code displays an example creating the connector object:


vx_req_connector_create *req;vx_req_connector_create_create(&req);req->connector_handle = vx_strdup("c1");req->acct_mgmt_server = vx_strdup("https://mt1s.www.vivox.com/api2/");int request_count;int vx_issue_request3_response = vx_issue_request3(&req->base, &request_count);

注意

To use the connector object effectively, it's important to understand that the connector object doesn't establish a persistent connection to the Vivox back end that needs to be maintained while using the service.

After the game receives the

vx_resp_connector_create

message, the game can then sign in to Vivox.

Disconnect the connector object

Disconnecting the connector object unloads the configuration file from memory. You can disconnect the object by using the

vx_req_connector_initiate_shutdown

request.

注意

It's never necessary to call

vx_req_connector_initiate_shutdown

unless you intend to change which Vivox back end you connect to after the initial connection.

Use

vx_uninitialize()

instead of

vx_req_connector_initiate_shutdown

on application exit to clean up Vivox resources.

文档

Development

User Acquisition

Monetization

工业

文档