Constructor Detail

• OrigonClient

  OrigonClient(Context context, ClientConfig config)

Method Detail

• getStartMessage

   final String getStartMessage()

• getIsChatEnabled

   final Boolean getIsChatEnabled()

• getIsCallEnabled

   final Boolean getIsCallEnabled()

• getMultipleChannels

   final Boolean getMultipleChannels()

• getAttachmentPolicy

   final AttachmentPolicy getAttachmentPolicy()

• getServerConfig

   final ServerConfig getServerConfig()

• close

   Unit close()

• setAttributes

   final Unit setAttributes(JsonObject attributes)

  Replace session-level attributes injected as data.attributes on subsequent startSession calls. Pass null to clear.

• getSessions

   final List<SessionSummary> getSessions()

  GET /sessions — prior sessions for the configured userId.

• getSession

   final SessionHistory getSession(String id)

  GET /session/<id> — history for one session.

• startSession

   final StartSessionResponse startSession(StartSessionOptions options)

  Open a session and return its StartSessionResponse(sessionId, url, token).

  Returning does not mean the media plane is connected. For a Channel.VOICE session the MoQ dial runs in the background after this returns: connect success arrives as a ClientEvent.Connected and a dial failure as a ClientEvent.Disconnected (TransportClosed) on the event stream — not as a thrown SessionException. Calling endSession with the returned id while still dialing cancels the in-flight dial. A Channel.CHAT session completes its (quick) SSE dial before returning and still throws on SSE-dial failure. Throws only for the /session/start HTTP failure, a chat SSE-dial failure, or a malformed request.

• joinSession

   final Unit joinSession(JoinSessionInput input)

  Attach to a session whose StartSessionResponse was obtained out of band (multi-device handoff, deeplink, persisted session).

  Like startSession, a Channel.VOICE session dials MoQ in the background — returning here does not mean it is connected; await the Connected / Disconnected event. A Channel.CHAT session completes its SSE dial before returning.

• endSession

   final Unit endSession(String id)

• endAllSessions

   final Unit endAllSessions()

• activeSessions

   final List<ActiveSession> activeSessions()

  Snapshot of every active session.

• setMute

   final Unit setMute(String id, Boolean muted)

• setMuteAll

   final Unit setMuteAll(Boolean muted)

• setAudioOutput

   final Unit setAudioOutput(AudioOutputRoute route)

  Override the audio output route (speaker / receiver / Bluetooth).

  Process-global — affects the app's single active voice session, so it takes no session id. A no-op when no call is active. UI typically wraps this as a boolean speaker toggle (AudioOutputRoute.SPEAKER / AudioOutputRoute.AUTOMATIC).

  May block while the audio output stream is reopened; call it off the main thread.

• sendMessage

   final Message sendMessage(String id, SendMessagePayload payload)

  Chat-only — send a text / HTML message on the named session.

  Requires an active chat session for id (call startSession first). The SDK fires ClientEvent.MessageAdded (provisional, status == SENDING) before the wire round-trip and ClientEvent.MessageUpdated (delivered or failed) after — both surface on pollEvent. Returns the server-issued Message.

• notifyTyping

   final Unit notifyTyping(String id)

  Chat-only — register a keystroke on the named session. Cheap to call from a TextWatcher; the SDK debounces outbound <sessionUrl>/typing POSTs so only one wire call fires per typing burst.

• stopTyping

   final Unit stopTyping(String id)

  Chat-only — force outbound typing state to "off" immediately, cancelling any in-flight debounce. UI fires this on empty-text transitions; the SDK also fires it implicitly on sendMessage and on endSession.

• uploadAttachment

   final Attachment uploadAttachment(String sessionId, String path, String fileName, String uploadId, Function1<UploadProgress, Unit> onProgress)

  Upload a file from the local filesystem to the named session and return the server-issued Attachment. The SDK streams the body straight from disk; auto-detects MIME from a 256-byte head plus the fileName extension. Runs on Dispatchers.IO.

  uploadId doubles as the cancellation key — pass it as attachmentId to deleteAttachment while the upload is in flight to abort it (throws with kind = ERROR_CANCELLED). After completion, use the server-issued attachment.id for deletion.

  onProgress fires from a JNI worker thread; hop to the main thread before touching UI state. percent is null when the total size is unknown.

  Throws SessionException: ERROR_OTHER for filesystem errors, ERROR_ATTACHMENT for precheck failures (empty_file, policy_unsupported_type, policy_type_disabled, policy_too_large), ERROR_HTTP / ERROR_SERVER_UNAVAILABLE for wire failures, ERROR_CANCELLED when cancelled.

• uploadAttachment

   final Attachment uploadAttachment(String sessionId, Uri uri, String fileName, String uploadId, Function1<UploadProgress, Unit> onProgress)

  Convenience overload that copies a content:// (or file:// / android.resource://) uri into the app's cache dir before uploading, then deletes the cache file once the upload settles. The SDK can't open content:// URIs directly.

• uploadAttachment

   final Attachment uploadAttachment(String sessionId, ByteArray bytes, String fileName, String uploadId, Function1<UploadProgress, Unit> onProgress)

  Convenience overload for in-memory bytes: writes them to the app's cache dir first, then delegates to the path-based overload.

• deleteAttachment

   final Unit deleteAttachment(String sessionId, String attachmentId)

  Cancel an in-flight upload or delete a completed attachment on the named session.

  attachmentId is dual-purpose: it can be either the uploadId passed to uploadAttachment (cancels the in-flight upload — no network call, the upload's awaiter throws SessionException with kind = SessionBridge.ERROR_CANCELLED) or the server-issued attachment.id of a completed upload (issues DELETE on the server). The SDK figures it out: it checks its in-flight uploads table first, then falls through to the wire call.

  Runs on Dispatchers.IO. A 404 from the server surfaces as SessionException with kind = SessionBridge.ERROR_HTTP and statusCode == 404 — safe to treat as success when your intent was "remove the draft from the UI".

• pollEvent

   final ClientEvent pollEvent()

  Polls the next event. Returns null when the queue is idle.