Blog

Kako odabrati API za videopozive: što usporediti prije izgradnje

· Andrij Tkachenko · 12 min čitanja

Povećalo iznad prozora videopoziva s dvije osobe, između globusa s linijama koje spajaju točke na njemu i lokota

API za videopozive odaberite prema onome što se događa sa zahtjevnim pozivima i prema onome što broji: spaja li se poziv kroz strogi vatrozid, koliko su njegovi poslužitelji blizu vašim korisnicima, tko može vidjeti medije i raste li račun s minutama, brojem ljudi ili razlučivošću. HD video, dijeljenje zaslona i zaslon poziva nalaze se na svakom popisu značajki, pa usluge razlikuju upravo ti odgovori.

Ovaj članak prolazi kroz deset pitanja koja vrijedi postaviti svakom API-ju za videopozive, SDK-u za videopozive ili API-ju za videokonferencije, uz to zašto je svako važno i kako odgovor provjeriti sami. Ne imenuje nijednu uslugu. Na kraju na svako pitanje odgovara za WordPlus Cloud, zajedno s onim što prepušta vama.

Sastanak koji ugradite ili pozivi u vašoj vlastitoj aplikaciji

Pod tim se nazivima prodaju dvije različite vrste usluga.

Usluga za sastanke daje vam sobu na stranici same usluge, koju ljudi otvaraju preko poveznice ili koju stavite u okvir na svojoj web-stranici. API za pozive daje vam dijelove: SDK za svaku platformu, često s gotovim zaslonom poziva, a pozivi se odvijaju unutar vaše vlastite aplikacije, između vaših vlastitih korisnika.

Ugrađeni sastanak API i SDK za pozive
Poziv se odvija Na stranici usluge, u okviru Na vašim zaslonima
Tko smije ući Tko god ima poveznicu Koga pusti vaš poslužitelj
Vi pišete Poveznicu Rutu za tokene i zaslon

Postoji i treći put, medijski poslužitelji otvorenog koda na vašim vlastitim poslužiteljima, i on vam ostavlja najviše toga za održavanje. Kako rade grupni videopozivi pokazuje što to traži. Deset pitanja u nastavku odnose se na prva dva.

1. Spaja li se svaki poziv?

Videopoziv ide izravno između dvaju uređaja kad to njihove mreže dopuštaju, a mnoge ne dopuštaju. Kućni usmjerivači, mobilne mreže i uredski vatrozidi svaki na svoj način skrivaju uređaje iza sebe, pa se dio poziva spaja samo preko releja, TURN poslužitelja, do kojeg mogu doći obje strane. Naš članak o STUN i TURN poslužiteljima objašnjava zašto.

Jednako je važno gdje taj relej sluša. TURN prema zadanim postavkama koristi port 3478, a preko TLS-a 5349, i njegov standard prenosi ga i preko TCP-a, jer neki vatrozidi potpuno blokiraju UDP. Hotelska ili uredska mreža koja van propušta samo portove weba blokira sve njih, pa prolazi samo relej na portu 443.

Pitajte:

  • Jesu li releji uključeni i na kojim portovima, među njima i 443?
  • Što se događa kad ni relej ne može proći: ne uspijeva li poziv ili prelazi na poslužitelj koji može?
  • Kad telefon prijeđe s Wi-Fija na mobilne podatke, nastavlja li se poziv ili se prekida?

Kad se poziv ne želi spojiti, naš članak o WebRTC vezama koje ne uspijevaju pokazuje kako saznati zašto.

2. Koliko su poslužitelji blizu vašim korisnicima?

Svaki relej i medijski poslužitelj dodaje put do sebe i natrag. Preporuka ITU-a o kašnjenju u pozivima, G.114, navodi da većina aplikacija ne trpi mnogo dok kašnjenje u jednom smjeru ostaje ispod 150 ms. Dvije osobe u istom gradu koje razgovaraju preko poslužitelja na drugom kontinentu čuju jedna drugu sa zakašnjenjem, iako žive nekoliko ulica jedna od druge.

Pitajte:

  • Gdje su releji i medijski poslužitelji i dolazi li svaka osoba sama do najbližeg?
  • U grupnom pozivu s ljudima na dva kontinenta idu li svi na jedan poslužitelj ili se svatko spaja na onaj blizu sebe?

Kako povezati korisnike iz različitih regija prolazi kroz to što svaki odgovor znači za poziv.

3. Rade li poziv udvoje i grupni poziv jednako?

Poziv između dvije osobe može ići izravno između uređaja. Grupni poziv to ne može čim ima više od nekoliko osoba, jer bi svaki uređaj morao slati svoju kameru svakom drugom. Zato grupni pozivi rade na medijskim poslužiteljima koji svaku kameru primaju jednom i prosljeđuju je ostalima, a mnoge ih usluge prodaju kao drugi proizvod, s vlastitim SDK-om i vlastitom cijenom.

Pitajte:

  • Kad se treća osoba pridruži pozivu udvoje, moraju li njih dvoje prekinuti i početi iznova?
  • Koliko osoba smije biti s videom istodobno, i koliko u jednom pozivu?
  • Mogu li neki ljudi samo slušati i govoriti tek kad im domaćin dopusti?

4. Što broji račun?

Većina API-ja za videopozive broji minute sudionika, minutu jedne osobe u pozivu. Nastava za 30 polaznika u trajanju od sat vremena iznosi 1.800 takvih minuta, pa je veličina vaših poziva važnija od njihova broja. Koliko košta videopoziv po minuti izračunava cijeli mjesec do kraja.

Zatim pogledajte što se još broji. Neke cijene rastu s razlučivošću, neke minute preko releja broje odvojeno, a snimanje, propusnost i pozivi između dvije osobe mogu svaki biti zasebna stavka.

Pitajte:

  • Broji li se minuta u HD-u kao minuta sa zvukom?
  • Broje li se pozivi između dvije osobe, i oni koji idu preko releja?
  • Što se događa iznad plana: prekida li se poziv ili se višak naplaćuje?

5. Tko može vidjeti i čuti poziv?

Svaki WebRTC poziv šifriran je na svom putu. Sigurnosna arhitektura WebRTC-a to zahtijeva: svi su mediji zaštićeni SRTP-om, s ključevima dogovorenima preko DTLS-a. Time se isključuje svatko na mreži između dvaju krajeva. Pitanje je gdje su krajevi. U pozivu izravno između dvaju uređaja krajevi su uređaji. U pozivu preko medijskog poslužitelja poslužitelj je jedan od krajeva i može vidjeti svaki okvir.

Grupni poziv ostaje skriven od svojih medijskih poslužitelja samo kad se svaki okvir šifrira prije nego što napusti uređaj, ključevima koje poslužitelji nikad ne drže. SFrame je IETF-ov standard za to, a neke usluge isto rade na svoj način.

Pitajte:

  • Tko drži ključeve grupnog poziva: usluga, moj poslužitelj ili samo ljudi u njemu?
  • Ostaje li poziv koji prijeđe na relej ili medijski poslužitelj i dalje šifriran s kraja na kraj?
  • Mora li usluga vidjeti medije da bi poziv snimila?

6. Tko odlučuje tko smije zvati i ući?

Poziv bi trebao početi samo ondje gdje vaša aplikacija kaže da. Kod većine API-ja vaš poslužitelj potpisuje token za svaki poziv ili sobu, a razlika je u tome koliko token kaže. Token koji korisnika samo pušta unutra uloge prepušta postavkama usluge. Token koji kaže tko govori, tko samo sluša, a tko je domaćin te odluke drži u vašem vlastitom kodu.

Pitajte:

  • Može li token dan jednoj osobi upotrijebiti netko drugi ili se njime ući u drugi poziv?
  • Može li moj poslužitelj nekoga utišati, ukloniti ga ili završiti poziv bez ijedne otvorene stranice?
  • Može li domaćin učiniti isto sa zaslona poziva, i samo domaćin?

7. Kako poziv dolazi do pozvane osobe?

Poziv koji zvoni u kartici koju nitko ne gleda propušten je poziv. Pitajte gdje zvoni: u svakoj kartici koju osoba ima otvorenu, na njezinu telefonu i na telefonu na kojem je aplikacija zatvorena. Zatvorena aplikacija zvoni samo preko sustava za pozive samog telefona, CallKita na iOS-u i okvira Telecom na Androidu, a SDK ih mora podržavati.

Pitajte:

  • Zvoni li poziv na svim uređajima odjednom i prestaje li svugdje čim se netko javi na jednom?
  • Zvoni li na zaključanom telefonu i pojavljuje li se na popisu nedavnih poziva?
  • Koliko dugo zvoni i što svaka strana dozna kad se nitko ne javi?

8. Postoji li gotov zaslon poziva i možete li ga mijenjati?

Zaslon poziva traži više posla nego što se čini: zvonjava, odabir kamere i mikrofona, mreža pločica koja se sama preslaže, tko govori, podijeljeni zaslon i zvuk koji preglednik drži utišanim dok netko ne klikne. Gotov zaslon štedi tjedne. Uz to mora izgledati kao ostatak vaše aplikacije.

Pitajte:

  • Koje ga platforme imaju: web, React, iOS, Android?
  • Mogu li promijeniti njegove boje i tekstove te jedan njegov dio zamijeniti svojim?
  • Je li ostatak SDK-a tu i za moj vlastiti zaslon, sve do svake osobe u grupnom pozivu?
  • Postoji li poslužiteljska biblioteka u jeziku u kojem pišem ili HTTP API?

9. Što se događa na slaboj mreži?

Pozivi se kvare na sitne načine dugo prije nego što posve zakažu. Svaki preglednik mora podržavati VP8 i H.264, kako zahtijeva RFC 7742, a što poziv radi na lošoj vezi ovisi o usluzi: smanjiti kvalitetu slike, odabrati drugi kodek, slati pakete zvuka dvaput ili odustati od kamere kako bi zadržao glas.

Pitajte:

  • Na slaboj vezi popušta li slika prije zvuka?
  • Dozna li moj zaslon koliko je dobra svaka veza, kako bi to mogao reći osobi?
  • Kad veza na trenutak nestane, koliko dugo poziv čeka na nju?

Telefon s jednom crticom signala na mobilnim podacima na ovo odgovara bolje od ijedne stranice specifikacija.

10. Što dozna vaš poslužitelj i koja su ograničenja?

Vaša aplikacija mora znati što se dogodilo: tko je zvao koga, koliko su dugo razgovarali i zašto je poziv završio. To joj treba da bi prikazala popis nedavnih poziva, ponudila poruku kad se nitko nije javio ili vlastitim korisnicima naplaćivala po minuti. To donose webhookovi, a budući da webhook može stići dvaput, svaki treba identifikator.

Zatim pročitajte stranicu s ograničenjima: koliko dugo poziv smije zvoniti i trajati, koliko osoba smije biti u jednom i koliko dugo token vrijedi. I zamislite dan kad odlazite. Poziv za sobom ostavlja manje nego chat. Ostaje vaš zapis o svakom pozivu, a njemu je mjesto u vašoj vlastitoj bazi podataka.

Odvojite poslijepodne i isprobajte sami

Cjenik i tablica značajki odgovaraju na malo ovih pitanja. Mali test odgovara na većinu. Na svakoj usluzi koju razmatrate izgradite najmanji poziv koji možete i prođite ovih sedam koraka:

  1. Uspostavite poziv između dva preglednika na različitim mrežama, jednog na Wi-Fiju, a drugog na telefonu koji koristi mobilne podatke.
  2. Nazovite s mreže koja van propušta samo web, primjerice sa strogog uredskog ili hotelskog Wi-Fija. Naš WebRTC test unaprijed pokazuje što ta mreža propušta.
  3. Tijekom poziva prebacite jedan telefon s Wi-Fija na mobilne podatke. Pogledajte nastavlja li se poziv.
  4. Dodajte treću osobu u poziv udvoje. Pogledajte moraju li njih dvoje najprije prekinuti.
  5. Kao pozvana osoba otvorite aplikaciju u dvije kartice i na telefonu na kojem je aplikacija zatvorena, pa nazovite tu osobu. Pogledajte gdje zvoni i prestaje li zvoniti drugdje čim se javi na jednom mjestu.
  6. Iz konzole preglednika pokušajte ući s tokenom koji je vaš poslužitelj dao nekome drugom ili s onim za drugi poziv.
  7. Otvorite stranicu potrošnje usluge i pročitajte kako je ovo poslijepodne izbrojeno.

Kako na njih odgovara WordPlus Cloud

WordPlus Cloud pripada drugoj vrsti: API za pozive, sa SDK-ovima i gotovim zaslonom poziva, na relejima i medijskim poslužiteljima koje sami vodimo. Istih deset pitanja, redom:

  1. Pozivi između dvije osobe spajaju se na tri puta, koji se isprobavaju redom: izravno između dvaju uređaja, preko naših releja na 443 i 80, portovima weba, i preko naših medijskih poslužitelja kad ni releji ne mogu proći. Poziv sam prelazi s jednog puta na drugi, bez prekidanja.
  2. Naši releji i medijski poslužitelji rade u nekoliko regija, a svaki uređaj sam dolazi do najbližeg. U grupnom pozivu svaka se osoba spaja na poslužitelj svoje regije, a naši poslužitelji prenose svaki tok između regija privatnim vezama. Stranica o mreži prikazuje ih na karti.
  3. Poziv udvoje postaje grupni poziv kad bilo koja strana nekoga doda, a da nitko ne prekida. Grupni pozivi rade na našim medijskim poslužiteljima, bez ograničenja broja osoba u pozivu, a vaš poslužitelj kaže tko govori, tko samo sluša, a tko je domaćin.
  4. Račun broji istodobne veze, od 1.000 naviše: $11.99 mjesečno uz godišnju naplatu ili $14.99 uz mjesečnu naplatu. Pozivi između dvije osobe uključeni su na svakom putu, preko releja ili ne. S 1.000 veza grupni pozivi ne troše kredite do 32 osobe s videom istodobno, pri čemu se osoba sa zvukom računa kao pola, a svakih daljnjih 1.000 veza dodaje 12. Iznad toga koštaju $0.20 za 1.000 minuta osobe s videom i $0.10 sa zvukom, a vaš plan dodaje 5.000 kredita mjesečno na svakih 1.000 veza. Jedna cijena pri svakoj razlučivosti, a propusnost i releji nikad se ne naplaćuju.
  5. Pozivi između dvije osobe šifrirani su s kraja na kraj na svakom putu, i preko naših releja i medijskih poslužitelja. Grupni poziv šifriran je s kraja na kraj kad tako kaže vaš poslužitelj: svaki se okvir šifrira prije nego što napusti uređaj, ključem koji daje samo vaš poslužitelj, a naši medijski poslužitelji prosljeđuju ono što ne mogu pročitati.
  6. Odlučuje vaš poslužitelj. Stranici daje token za svaki poziv koji dopušta i za svaku osobu koja ulazi u grupni poziv, a token kaže tko govori, tko samo sluša, a tko je domaćin. Domaćini isključuju mikrofon, puštaju nekoga da govori i uklanjaju nekoga, a vaš poslužitelj može učiniti isto bez ijedne otvorene stranice i u bilo kojem trenutku oduzeti pristup.
  7. Poziv zvoni u svakoj kartici i aplikaciji koju pozvana osoba ima otvorenu, 45 sekundi, i prestaje zvoniti svugdje čim se javi na jednoj. SDK-ovi za iOS i Android zvone na zaključanom telefonu i kad je aplikacija zatvorena, kao telefonski poziv, preko CallKita i Androidovih obavijesti o pozivima. Svaki poziv kaže zašto je završio, pa i kad se nitko nije javio.
  8. Gotov zaslon poziva na webu, iOS-u i Androidu: gumbi za pozive, zvonjava i prozor poziva, na devet jezika. Promijenite njegove boje i tekstove, zamijenite jedan njegov dio svojim ili nacrtajte vlastito sučelje na istom SDK-u. Poslužiteljske biblioteke za Node.js, PHP i Python, vodiči za Next.js, Express, Laravel, običan PHP, Django, FastAPI i Flask te HTTP API za bilo koji drugi jezik.
  9. U pozivu između dvije osobe veza druge strane javlja se kao izvrsna, dobra, loša ili izgubljena, zajedno s putom kojim je poziv krenuo, pa vaš zaslon to može prikazati. Poziv sam mijenja put kad se mreža promijeni, a veza jedne strane može nestati do 45 sekundi i vratiti se.
  10. Vaš poslužitelj za svaki poziv dozna preko webhooka: tko je zvao koga, kada se pozvana osoba javila, koliko su sekundi razgovarali i zašto je poziv završio te kada je svaka osoba ušla u grupni poziv i izašla iz njega, izbrojeno na našim poslužiteljima. Poziv zadržava svoj identifikator koliko god se puta njegov webhook poslao, pa se ponovljeni sprema samo jednom. Ograničenja su objavljena: poziv zvoni 45 sekundi, token poziva vrijedi do 6 sati, a strana čija veza nestane ima 45 sekundi da se vrati.

Vodič za pozive ima kod svakog dijela u svakom stacku. Kako ugraditi videopozive u Next.js aplikaciju korak po korak izgrađuje cijelu aplikaciju, a demo uživo omogućuje vam da je otvorite u dva preglednika i nazovete iz jednog u drugi.

Što prepušta vama

  • Ruta koja izdaje tokene. Tko smije zvati koga vaša je vlastita logika, pa je to kod koji pišete vi, a isto vrijedi i za zapis koji vaš webhook čuva o svakom pozivu.
  • Obavijest da je netko propustio poziv. Poziv zvoni 45 sekundi gdje god osoba ima stranicu ili aplikaciju. Nakon toga vaš poslužitelj dozna da se nitko nije javio, a e-poruku ili poruku šaljete vi.
  • Snimanje. SDK-ovi za aplikacije danas ne snimaju pozive.
  • Telefonski brojevi. Pozivi se odvijaju između korisnika vaše aplikacije, preko interneta, bez telefonskih brojeva i bez telefonske mreže.

Ako želite sastanak kojem se svatko pridružuje preko poveznice, bez ikakve vaše aplikacije oko njega, bolje će vam odgovarati usluga za sastanke koju ugradite. Isto vrijedi ako vaši pozivi moraju dopirati do telefonskih brojeva.

Počnite s vodičem za pozive

WordPlus Cloud for Apps ima cijenu prema istodobnim vezama, od 1.000 naviše, uz mjesečnu ili godišnju naplatu. Pozivi između dvije osobe su uključeni, a isti plan i SDK donose grupne pozive, prijenose uživo i chat na istoj vezi. Pogledajte API i SDK za videopozive za svaki zadatak u svakom stacku, što oblak nudi aplikacijama ili cijene za aplikacije. Birate uslugu i za chat? Kako odabrati chat API isto pita za poruke. Emitirate i uživo za publiku? Kako odabrati API za prijenos uživo isto pita za prijenos. Pitanja o vašoj integraciji? Pišite nam.