Section:

Connecting to a server to collaborate on documents in realtime

Host annotations in your own server

In realtime collaboration, a server will merely act as an online database that triggers events upon data creation/modification/deletion. As long as the above requirement is met, your server can be built in any language and stack of your choice. Apryse provides an interface that will allow you to connect your data to the out-of-box UI.

  1. Your will need to obtain a reference to CollabManager from the CollabViewerTabHostFragment2, then setup the current collaboration session, for example:
1void handleTabDocumentLoaded(String tag) {
2    // setup the current collaboration session
3    CollabManager collabManager = mCollabViewerTabHostFragment.getCollabManager();
4    if (collabManager != null) {
5        collabManager.setCurrentUser(mUserId, mUserName);
6        collabManager.setCurrentDocument(mDocumentId);
7
8        collabManager.setCollabManagerListener(new CollabManager.CollabManagerListener() {
9            @Override
10            public void onSendAnnotation(String action, ArrayList<AnnotationEntity> annotations, String documentId, @Nullable String userName) {
11                // local change, send info to server here
12            }
13        });
14    }
15}
  1. When your server notifies the client about remote changes, import the XFDF command string with CollabManager:
1void importXfdf(String xfdfCommand) {
2    CollabManager collabManager = mCollabViewerTabHostFragment.getCollabManager();
3    if (collabManager != null) {
4        collabManager.importAnnotationCommand(xfdfCommand);
5    }
6}

The annotations appearing on the document in real time are managed through a separate XFDF format, while the original version of the document is preserved on the server. Note that the client downloads the original untouched document at the start of the collaboration session.

And that is it! Apryse will handle all annotation syncing and annotation reply for you.

Did you find this helpful?

Trial setup questions?

Ask experts on Discord

Need other help?

Contact Support

Pricing or product questions?

Contact Sales