4. Eşler arası bağlantılar

4.4 RTCPeerConnection Arayüzü

[RFC9429] belirtimi, bir bütün olarak, RTCPeerConnectionın nasıl çalıştığının ayrıntılarını açıklar. [RFC9429] içindeki belirli alt bölümlere yapılan atıflar uygun yerlerde verilmiştir.

4.4.1 Çalışma

new RTCPeerConnection(configuration) çağrısı bir RTCPeerConnection nesnesi oluşturur.

configuration.iceServers, ICE tarafından kullanılan sunucuların bulunması ve bunlara erişilmesi için kullanılan bilgileri içerir. Uygulama her türden birden fazla sunucu sağlayabilir ve herhangi bir TURN sunucusu, sunucuya özgü yansımalı adayların toplanması amacıyla bir STUN sunucusu olarak da MAY kullanılabilir.

Bir RTCPeerConnection nesnesinin bir [[SignalingState]]i ve birleştirilmiş [[ConnectionState]], [[IceGatheringState]] ve [[IceConnectionState]] durumları vardır. Bunlar nesne oluşturulduğunda başlatılır.

Bir RTCPeerConnectionın ICE protokolü uygulaması, bir ICE aracısı [RFC5245] ile temsil edilir. Bazı RTCPeerConnection metotları ICE aracısı ile etkileşim içerir; bunlar addIceCandidate, setConfiguration, setLocalDescription, setRemoteDescription ve close metotlarıdır. Bu etkileşimler, bu belgedeki ilgili bölümlerde ve [RFC9429] içinde açıklanmıştır. ICE aracısı ayrıca, 5.6 RTCIceTransport Arayüzü bölümünde açıklandığı gibi, dahili RTCIceTransport temsillerinin durumu değiştiğinde kullanıcı aracısına bildirimler sağlar.

Bu bölümde listelenen görevler için görev kaynağı ağ görev kaynağıdır.

4.4.1.1 Kurucu

RTCPeerConnection.constructor() çağrıldığında, kullanıcı aracısı aşağıdaki adımları MUST çalıştırmalıdır:

1. Aşağıda sıralanan adımlardan herhangi biri burada belirtilmeyen bir nedenle başarısız olursa, message özniteliği uygun bir açıklamaya ayarlanmış bir UnknownError fırlat.
2. connection, yeni oluşturulmuş bir RTCPeerConnection nesnesi olsun.
3. connectionın, ilgili ayarlar nesnesinin origin değeriyle başlatılmış bir [[DocumentOrigin]] dahili yuvası olsun.
4. configuration, metodun ilk argümanı olsun.
5. configuration içindeki certificates değeri boş değilse, sertifikalar içindeki her certificate için aşağıdaki adımları çalıştır:
6. certificate.expires değeri mevcut zamandan küçükse, bir InvalidAccessError fırlat.
7. certificate.[[Origin]], connection.[[DocumentOrigin]] ile aynı origin değilse, bir InvalidAccessError fırlat.
8. certificatei depola.
9. Aksi halde, bu RTCPeerConnection örneğiyle bir veya daha fazla yeni RTCCertificate örneği üret ve bunları depola. Bu işlem eşzamansız olarak gerçekleşebilir (MAY) ve sonraki adımlar için certificates değeri undefined olarak kalır. [RFC8826] Bölüm 4.3.2.3'te belirtildiği gibi, WebRTC, Genel Anahtar Altyapısı (PKI) sertifikaları yerine kendinden imzalı sertifikalar kullanır; bu nedenle sona erme denetimi, anahtarların süresiz kullanılmamasını sağlamak içindir ve ek sertifika denetimleri gerekli değildir.
10. connectionın ICE aracısını başlat.
11. connectionın, null ile başlatılmış bir [[Configuration]] dahili yuvası olsun. configuration tarafından belirtilen yapılandırmayı ayarla.
12. connectionın, false ile başlatılmış bir [[IsClosed]] dahili yuvası olsun.
13. connectionın, false ile başlatılmış bir [[NegotiationNeeded]] dahili yuvası olsun.
14. connectionın, null ile başlatılmış bir [[SctpTransport]] dahili yuvası olsun.
15. connectionın, boş sıralı bir küme ile başlatılmış bir [[DataChannels]] dahili yuvası olsun.
16. connectionın, bir işlemler zincirini temsil eden ve boş bir liste ile başlatılmış bir [[Operations]] dahili yuvası olsun.
17. connectionın, false ile başlatılmış bir [[UpdateNegotiationNeededFlagOnEmptyChain]] dahili yuvası olsun.
18. connectionın, "" ile başlatılmış bir [[LastCreatedOffer]] dahili yuvası olsun.
19. connectionın, "" ile başlatılmış bir [[LastCreatedAnswer]] dahili yuvası olsun.
20. connectionın, boş bir liste ile başlatılmış bir [[EarlyCandidates]] dahili yuvası olsun.
21. connectionın, "stable" ile başlatılmış bir [[SignalingState]] dahili yuvası olsun.
22. connectionın, "new" ile başlatılmış bir [[IceConnectionState]] dahili yuvası olsun.
23. connectionın, "new" ile başlatılmış bir [[IceGatheringState]] dahili yuvası olsun.
24. connectionın, "new" ile başlatılmış bir [[ConnectionState]] dahili yuvası olsun.
25. connectionın, null ile başlatılmış bir [[PendingLocalDescription]] dahili yuvası olsun.
26. connectionın, null ile başlatılmış bir [[CurrentLocalDescription]] dahili yuvası olsun.
27. connectionın, null ile başlatılmış bir [[PendingRemoteDescription]] dahili yuvası olsun.
28. connectionın, null ile başlatılmış bir [[CurrentRemoteDescription]] dahili yuvası olsun.
29. connectionın, boş bir küme ile başlatılmış bir [[LocalIceCredentialsToReplace]] dahili yuvası olsun.
30. connectionı döndür.

4.4.1.2 Eşzamansız bir işlemi zincire ekleme

Bir RTCPeerConnection nesnesinin, [[Operations]] adlı bir işlemler zinciri vardır; bu zincir, zincirde aynı anda yalnızca bir eşzamansız işlemin yürütülmesini sağlar. Önceki bir çağrının döndürdüğü promise henüz sonuçlanmamışken sonraki çağrılar yapılırsa, bunlar zincire eklenir ve önceki çağrıların tümü yürütülüp promise'leri sonuçlandıktan sonra çalıştırılır.

Bir işlemi bir RTCPeerConnection nesnesinin işlemler zincirine eklemek için aşağıdaki adımları çalıştır:

1. connection, RTCPeerConnection nesnesi olsun.
2. connection.[[IsClosed]] true ise, yeni oluşturulmuş bir InvalidStateError ile reddedilmiş bir promise döndür.
3. operation, zincire eklenecek işlem olsun.
4. p, yeni bir promise olsun.
5. operationı [[Operations]]e ekle.
6. [[Operations]]in uzunluğu tam olarak 1 ise, operationı yürüt.
7. operation tarafından döndürülen promise'in yerine getirilmesi veya reddedilmesi üzerine, aşağıdaki adımları çalıştır:
8. connection.[[IsClosed]] true ise, bu adımları iptal et.
9. operation tarafından döndürülen promise bir değerle yerine getirilmişse, pyi bu değerle yerine getir.
10. operation tarafından döndürülen promise bir değerle reddedilmişse, pyi bu değerle reddet.
11. pnin yerine getirilmesi veya reddedilmesi üzerine, aşağıdaki adımları çalıştır:
12. connection.[[IsClosed]] true ise, bu adımları iptal et.
13. [[Operations]]in ilk elemanını kaldır.
14. [[Operations]] boş değilse, [[Operations]]in ilk elemanının temsil ettiği işlemi yürüt ve bu adımları iptal et.
15. connection.[[UpdateNegotiationNeededFlagOnEmptyChain]] false ise, bu adımları iptal et.
16. connection.[[UpdateNegotiationNeededFlagOnEmptyChain]] değerini false olarak ayarla.
17. connection için müzakere-gerekli bayrağını güncelle.
18. pyi döndür.

4.4.1.3 Bağlantı durumunu güncelleme

Bir RTCPeerConnection nesnesinin birleştirilmiş bir [[ConnectionState]]i vardır. Bir RTCDtlsTransportun durumu her değiştiğinde, kullanıcı aracısı aşağıdaki adımları çalıştıran bir görevi MUST kuyruğa almalıdır:

1. connection, durumu değişen RTCDtlsTransport nesnesiyle ilişkili bu RTCPeerConnection nesnesi olsun.
2. connection.[[IsClosed]] true ise, bu adımları iptal et.
3. newState, RTCPeerConnectionState enumu tarafından açıklandığı şekilde yeni bir durum değerinin türetilmesinin sonucu olsun.
4. connection.[[ConnectionState]], newStatee eşitse, bu adımları iptal et.
5. connection.[[ConnectionState]]i newState olarak ayarla.
6. connection üzerinde connectionstatechange adlı bir olay tetikle.

4.4.1.4 Oturum açıklamasını ayarlama

Bir RTCPeerConnection nesnesi connection üzerinde yerel bir oturum açıklaması description ayarlamak için, description oturum açıklamasını ek false değeriyle birlikte connection üzerinde ayarla.

Bir RTCPeerConnection nesnesi connection üzerinde uzak bir oturum tanımı description ayarlamak için, connection üzerinde oturum tanımı description ek olarak true değeriyle ayarlanır.

Bir RTCPeerConnection nesnesi connection üzerinde, bir remote boolean değeri verildiğinde, bir oturum tanımı description ayarlamak için aşağıdaki adımları çalıştırın:

1. p yeni bir promise olsun.
2. Eğer description.type "rollback" ise ve connection.[[SignalingState]] "stable", "have-local-pranswer" veya "have-remote-pranswer" durumlarından biriyse, yeni oluşturulmuş bir InvalidStateError ile p’yi reddedin ve bu adımları sonlandırın.
3. jsepSetOfTransceivers, connection’ın transceiver kümesinin sığ bir kopyası olsun.
4. Paralel olarak, [RFC9429]’da (bölüm 5.5. ve bölüm 5.6.) tanımlandığı şekilde description’ı uygulama sürecini, aşağıdaki ek kısıtlamalarla başlatın:
5. Hangi "RtpTransceivers"’ların mevcut olduğu ve bunların "mid özelliği" olarak [[JsepMid]] iç yuvaları konusunda doğruluk kaynağı olarak jsepSetOfTransceivers kullanın.
6. Aday Düzeltmesi 5: İdari olarak yasaklanmış adaylar üzerinde ICE toplama ve bağlantı denetimlerini yasakla (PR #2708)

Eğer remote false ise ve bu durum [RFC9429]’da (bölüm 5.9.) ICE aday toplama sürecini tetiklerse, ICE aracısı idari olarak yasaklanmış adayları MUST NOT toplamalıdır.

7. Aday Düzeltmesi 5: İdari olarak yasaklanmış adaylar üzerinde ICE toplama ve bağlantı denetimlerini yasakla (PR #2708)

Eğer remote true ise ve bu durum [RFC9429]’da (bölüm 5.10.) ICE bağlantı denetimlerini tetiklerse, ICE aracısı idari olarak yasaklanmış adaylara bağlanmayı MUST NOT denemelidir.

8. Eğer remote true ise, araya yanıtlar uygulanmış gibi, arka arkaya teklifler için doğrulama yapın; bunu, kararlı durumda gibi sonraki teklifler için denetimi çalıştırarak yapın.
9. Aday Düzeltmesi 37: RID uyuşmazlığı nedeniyle sRD(offer) başarısız olmasın, sadece unicast ile yanıt verilsin. (PR #2794)
10. Eğer description’ın uygulanması bir transceiver’ın değiştirilmesine yol açarsa ve transceiver.[[Sender]].[[SendEncodings]] boş değilse ve description’ın işlenmesi sonucunda oluşacak kodlamalara eşit değilse, description’ı uygulama süreci başarısız olur. Bu belirtim, uzaktan başlatılan RID yeniden müzakeresine izin vermez.
11. Eğer description’ı uygulama süreci herhangi bir nedenle başarısız olursa, kullanıcı aracısı aşağıdaki adımları çalıştıran bir görevi sıraya almalıdır (MUST):
12. Eğer connection.[[IsClosed]] true ise, bu adımları sonlandırın.
13. Eğer description.type, [RFC9429]’da (bölüm 5.5. ve bölüm 5.6.) tanımlandığı şekilde mevcut connection.[[SignalingState]] için geçersizse, yeni oluşturulmuş bir InvalidStateError ile p’yi reddedin ve bu adımları sonlandırın.
14. Eğer description’ın içeriği geçerli SDP sözdizimi değilse, errorDetail değeri "sdp-syntax-error" olarak ayarlanmış ve sdpLineNumber özniteliği sözdizimi hatasının algılandığı SDP satır numarasına ayarlanmış bir RTCError ile p’yi reddedin ve bu adımları sonlandırın.
15. Eğer remote true ise, connection’ın RTCRtcpMuxPolicy değeri require ise ve tanım RTCP mux kullanmıyorsa, yeni oluşturulmuş bir InvalidAccessError ile p’yi reddedin ve bu adımları sonlandırın.
16. Eğer tanım, yukarıda açıklandığı gibi RID’leri yeniden müzakere etmeye çalıştıysa, yeni oluşturulmuş bir InvalidAccessError ile p’yi reddedin ve bu adımları sonlandırın.
17. Eğer description’ın içeriği geçersizse, yeni oluşturulmuş bir InvalidAccessError ile p’yi reddedin ve bu adımları sonlandırın.
18. Diğer tüm hatalar için, yeni oluşturulmuş bir OperationError ile p’yi reddedin.
19. Eğer description başarıyla uygulanırsa, kullanıcı aracısı aşağıdaki adımları çalıştıran bir görevi sıraya almalıdır (MUST):
20. Eğer connection.[[IsClosed]] true ise, bu adımları sonlandırın.
21. Eğer remote true ise ve description "offer" türündeyse, description’ı uygulama süreci sırasında connection üzerindeki herhangi bir addTrack() yöntemi başarılı olduysa, bu adımları sonlandırın ve ekstra transceiver(lar)ı sürece dahil etmek için, sanki bunlar önceden başarılı olmuş gibi süreci yeniden başlatın.
22. Eğer connection ile ilişkili RTCRtpSender’lardaki setParameters yöntemlerinden kaynaklanan herhangi bir promise sonuçlanmamışsa, bu adımları sonlandırın ve süreci yeniden başlatın.
23. Eğer description "offer" türündeyse ve connection.[[SignalingState]] "stable" ise, connection’ın transceiver kümesindeki her transceiver için aşağıdaki adımları çalıştırın:
24. transceiver.[[Sender]].[[LastStableStateSenderTransport]] değerini transceiver.[[Sender]].[[SenderTransport]] olarak ayarlayın.
25. Aday Düzeltmesi 13: Geri alma, sRD(simulcastOffer) tarafından ezilen RID’siz kodlamayı geri yükler. (PR #2797)

Eğer transceiver.[[Sender]].[[SendEncodings]].length 1 ise ve tek kodlama hiçbir rid üyesi içermiyorsa, transceiver.[[Sender]].[[LastStableRidlessSendEncodings]] değerini transceiver.[[Sender]].[[SendEncodings]] olarak ayarlayın; aksi halde transceiver.[[Sender]].[[LastStableRidlessSendEncodings]] değerini null olarak ayarlayın.

26. transceiver.[[Receiver]].[[LastStableStateReceiverTransport]] değerini transceiver.[[Receiver]].[[ReceiverTransport]] olarak ayarlayın.
27. transceiver.[[Receiver]].[[LastStableStateAssociatedRemoteMediaStreams]] değerini transceiver.[[Receiver]].[[AssociatedRemoteMediaStreams]] olarak ayarlayın.
28. transceiver.[[Receiver]].[[LastStableStateReceiveCodecs]] değerini transceiver.[[Receiver]].[[ReceiveCodecs]] olarak ayarlayın.
29. Eğer remote false ise, aşağıdaki adımlardan birini çalıştırın:
30. Eğer description "offer" türündeyse, connection.[[PendingLocalDescription]] değerini description’dan oluşturulmuş yeni bir RTCSessionDescription nesnesine ayarlayın, connection.[[SignalingState]] değerini "have-local-offer" olarak ayarlayın ve erken adayları serbest bırakın.
31. Eğer description "answer" türündeyse, bu bir teklif-yanıt müzakeresini tamamlar. connection.[[CurrentLocalDescription]] değerini description’dan oluşturulmuş yeni bir RTCSessionDescription nesnesine ayarlayın ve connection.[[CurrentRemoteDescription]] değerini connection.[[PendingRemoteDescription]] olarak ayarlayın. Hem connection.[[PendingRemoteDescription]] hem de connection.[[PendingLocalDescription]] değerlerini null olarak ayarlayın. Hem connection.[[LastCreatedOffer]] hem de connection.[[LastCreatedAnswer]] değerlerini "" olarak ayarlayın, connection.[[SignalingState]] değerini "stable" olarak ayarlayın ve erken adayları serbest bırakın. Son olarak, connection.[[LocalIceCredentialsToReplace]] içindeki ICE kimlik bilgilerinin hiçbiri description içinde yoksa, connection.[[LocalIceCredentialsToReplace]] değerini boş bir küme olarak ayarlayın.
32. Eğer description "pranswer" türündeyse, connection.[[PendingLocalDescription]] değerini description’dan oluşturulmuş yeni bir RTCSessionDescription nesnesine ayarlayın, connection.[[SignalingState]] değerini "have-local-pranswer" olarak ayarlayın ve erken adayları serbest bırakın.
33. Aksi halde, (remote true ise) aşağıdaki adımlardan birini çalıştırın:
34. Eğer description "offer" türündeyse, connection.[[PendingRemoteDescription]] özniteliğini description’dan oluşturulmuş yeni bir RTCSessionDescription nesnesine ayarlayın ve connection.[[SignalingState]] değerini "have-remote-offer" olarak ayarlayın.
35. Eğer description "answer" türündeyse, bu bir teklif-yanıt müzakeresini tamamlar. connection.[[CurrentRemoteDescription]] değerini description’dan oluşturulmuş yeni bir RTCSessionDescription nesnesine ayarlayın ve connection.[[CurrentLocalDescription]] değerini connection.[[PendingLocalDescription]] olarak ayarlayın. Hem connection.[[PendingRemoteDescription]] hem de connection.[[PendingLocalDescription]] değerlerini null olarak ayarlayın. Hem connection.[[LastCreatedOffer]] hem de connection.[[LastCreatedAnswer]] değerlerini "" olarak ayarlayın ve connection.[[SignalingState]] değerini "stable" olarak ayarlayın. Son olarak, connection.[[LocalIceCredentialsToReplace]] içindeki ICE kimlik bilgilerinin hiçbiri yeni ayarlanan connection.[[CurrentLocalDescription]] içinde yoksa, connection.[[LocalIceCredentialsToReplace]] değerini boş bir küme olarak ayarlayın.
36. Eğer description "pranswer" türündeyse, connection.[[PendingRemoteDescription]] değerini description’dan oluşturulmuş yeni bir RTCSessionDescription nesnesine ayarlayın ve connection.[[SignalingState]] değerini "have-remote-pranswer" olarak ayarlayın.
37. Eğer description "answer" türündeyse ve [RFC8841], Bölüm 10.3 ve 10.4’te tanımlandığı şekilde mevcut bir SCTP ilişkisinin kapatılmasını başlatıyorsa, connection.[[SctpTransport]] değerini null olarak ayarlayın.
38. trackEventInits, muteTracks, addList, removeList ve errorList boş listeler olsun.
39. Eğer description "answer" veya "pranswer" türündeyse, aşağıdaki adımları çalıştırın:
40. Eğer description, [RFC8841], Bölüm 10.3 ve 10.4’te tanımlandığı şekilde yeni bir SCTP ilişkisinin kurulmasını başlatıyorsa, başlangıç durumu "connecting" olan bir RTCSctpTransport oluşturun ve sonucu [[SctpTransport]] yuvasına atayın. Aksi halde, bir SCTP ilişkisi kurulmuşsa ancak max-message-size SDP özniteliği güncellenmişse, connection.[[SctpTransport]]’un veri azami mesaj boyutunu güncelleyin.
41. Eğer description SCTP taşımasının DTLS rolünü müzakere ediyorsa, id değeri null olan her RTCDataChannel (channel) için aşağıdaki adımı çalıştırın:
42. [RFC8832]’ye göre oluşturulmuş yeni bir kimliği channel’a verin. Eğer kullanılabilir bir kimlik oluşturulamazsa, channel.[[ReadyState]] değerini "closed" olarak ayarlayın ve channnel’ı errorList’e ekleyin.
43. Eğer description "rollback" türünde değilse, aşağıdaki adımları çalıştırın:
44. Eğer remote false ise, description içindeki her medya tanımı için aşağıdaki adımları çalıştırın:

Aday Düzeltmesi 26: createAnswer()’ın kodlamalarını ve sLD(answer) içindeki SendEncodings’i buda. (PR #2801)

1. Eğer medya tanımı henüz bir RTCRtpTransceiver nesnesiyle ilişkilendirilmemişse, aşağıdaki adımları çalıştırın:
2. transceiver, medya tanımını oluşturmak için kullanılan RTCRtpTransceiver olsun.
3. transceiver.[[Mid]] değerini transceiver.[[JsepMid]] olarak ayarlayın.
4. Eğer transceiver.[[Stopped]] true ise, bu alt adımları sonlandırın.
5. Eğer medya tanımı, [RFC8843]’e göre mevcut bir media medya taşımasını kullandığını gösteriyorsa, transport, o taşımanın RTP/RTCP bileşenini temsil eden RTCDtlsTransport nesnesi olsun.
6. Aksi halde, transport, yeni bir temel RTCIceTransport ile yeni oluşturulmuş bir RTCDtlsTransport nesnesi olsun.
7. transceiver.[[Sender]].[[SenderTransport]] değerini transport olarak ayarlayın.
8. transceiver.[[Receiver]].[[ReceiverTransport]] değerini transport olarak ayarlayın.
9. transceiver, medya tanımıyla ilişkili RTCRtpTransceiver olsun.
10. Eğer transceiver.[[Stopped]] true ise, bu alt adımları sonlandırın.
11. direction, media medya tanımından yönü temsil eden bir RTCRtpTransceiverDirection değeri olsun.
12. Eğer direction "sendrecv" veya "recvonly" ise, transceiver.[[Receptive]] değerini true olarak ayarlayın; aksi halde false olarak ayarlayın.
13. transceiver.[[Receiver]].[[ReceiveCodecs]] değerini, description’ın alma için müzakere ettiği ve kullanıcı aracısının şu anda almaya hazır olduğu kodeklere ayarlayın.