Good example of using Readium as a core application component for navigation?

[mcpierce]

I'm working on an OPDS reader application (cross platform, targeting iPad and Android tablets) to use with my server project (ComiXed). I've been using Readium to retrieve the OPDS feed, and am currently struggling with getting it to download a publication from the server.

Is it possible to use Readium as the core of the app's server navigations? IOW, is there a way I can provide a component of Readium the server details (hostname, port, initial uri, username, password) and have it do the interactions, and just have my app respond to state changes during navigation? It would certainly make the application easier to write.

I looked but didn't see a decent example of how to do this. Is there an example somewhere of just this sort of application?

[qnga]

Hi,
If I understand correctly, what you are looking for is a piece of UI enabling users to navigate through OPDS feeds. It would require some decisions about UI so it's out of the scope of Readium and we don't have one.

All what Readium can do for you is parsing responses from your OPDS server and, for convenience, doing the HTTP requests (see OPDS1Parser and OPDS2Parser).

[mcpierce]

No that’s actually he opposite of what I asked. I want to attach my own UX components to Readium to display the links, publications, etc. when a user wants to navigate our server. I’m asking for an example app that’s shows how one would initiate events in readium to talk to a server and provide navigation events.

[mickael-menu]

Would you mind sharing what this ideal API for you would look like?

[mcpierce]

Sure. What I imagine it would be like is to have a core object where you set the connection details (address, port, protocol, username, password), register a callback method that is invoked when a set of navigation links is returned, a callback for updating the application state with the details for a single publication, and a similar one for when a publication is downloaded.

The core object would also have a method that takes as input a URI (initially it would be given the root URI for the site), call the server, process the payload, and invoke the appropriate callback for either links or a single publication.

There would also be a way to register a translator that converts the various domain objects from Readium's internal representation to an application-specific representation.

With that sort of framework, a developer could integrate Readium into the core of an app like the one I'm writing and focus on responding to events (initiating navigation, displaying links or a publication, storing a publication after download) rather than the details of connecting to the site.

[qnga]

Have a look at the test apps. That's all what we have.