Skip to content
/ owl Public

WebRTC based real time communication protocol service.

Notifications You must be signed in to change notification settings

appdets/owl

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

OWL never sleeps!

Tiny flagship real time web push notification / message service based on WebSocket. It works on cross browser, cross platform and cross environment. So, waiting for?

Usages

  • Real-time notification
  • Purchase alert
  • Web alert
  • Send LIVE notice
  • Live CHAT
  • Audio call
  • Video call
  • Screen shares
  • Reverse sharing (Live to Local)

Get Started

ES6

npm i -D owl-client

Play with CDN

<script src="https://air.appdets.com/owl.js"></script>

JSDeliver

<script src="https://cdn.jsdelivr.net/npm/owl-client/owl.js"></script>

Authentication

ES6

// ES6 or module 
import Owl from 'owl-client';

// Non-module / CDN
const Owl = window.Owl;

const msg = Owl.init('yourChannelName')

What is channel

Channel is kinda group chat or chat room. You will connect through the channel name your defined. All the data are passes through your channel.

Send your first message

Send message to everyone in the channel

msg.send('Hello world');

// or 

msg.send({
    type: "msg",
    text: "This is a JSON message"
})

// `send` method accepts string, numbers, boolean, objects, array, stream anything as argument

Broadcast message to everyone expect the sender

msg.broadcast({
    type: "msg",
    text: "This is a JSON message"
})

Send message to specific user

msg.to( 
    user, 
    { type: "msg", text: "This is a JSON message" }
    )

Receive your first message

msg.receive((msg) => {
    console.log('Just received', msg)
});

Other events

msg.connect((data) => {
    // Owl is connected
});

List of all events

connect

disconnect

error

receive

Send message using REST API

You can also send message using REST API following the method bellow

Using CURL

curl https://air.appdets.com/send -a 
   -H "Accept: application/json"
   -d "{\"channel\": \"yourChannelName\", \"message\": \"hello world\"}" 

Using JavaScript

(async function(){
    const req = await fetch('https://air.appdets.com/send', {
        method: "POST",
        headers: {
            "Content-Type": "application/json",
        },
        body: JSON.stringify({ channel: "yourChannelName",  message: "Hello world" })
    }) 

    const res = await req.json()
    console.log(res)
    // {
    // 	"success": true,
    // }
})()

Using WordPress

$response = wp_remote_post('https://air.appdets.com/send', [
    "headers" => [ 
        "Content-Type" =>
        
        "application/json",
    ],
    "body" => [
        "channel" => "yourChannelName",
        "message" => "hello world"
    ]
]); 

$responseBody = json_decode(wp_remote_retrieve_body( $response )); 
 

Early Bird Access!

This is on beta mode, so you have to apply for access before you start.

Please send a request mail to [email protected] with your proper explanation, like what and why you would like to use Owl for your purpose?

Here is a shortlist of question that we need from you;

  • What is your profession?
  • Why you would like to use Owl?
  • What is the basic cases of your usages?
  • How often you will send/receive data? Like N per day.
  • What is the maximum estimated byte size of your each message?

Contribution?

Ops, currently, contribution on this project is OFF. But you have any suggestion, please send us email at [email protected]

About

WebRTC based real time communication protocol service.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published