xref: /aosp_15_r20/external/webrtc/stats/g3doc/stats.md (revision d9f758449e529ab9291ac668be2861e7a55c2422)
1*d9f75844SAndroid Build Coastguard Worker<?% config.freshness.reviewed = '2022-10-01' %?>
2*d9f75844SAndroid Build Coastguard Worker<?% config.freshness.owner = 'hta' %?>
3*d9f75844SAndroid Build Coastguard Worker
4*d9f75844SAndroid Build Coastguard Worker# getStats in WebRTC
5*d9f75844SAndroid Build Coastguard Worker
6*d9f75844SAndroid Build Coastguard WorkerThe WebRTC getStats API is specified in
7*d9f75844SAndroid Build Coastguard Worker  https://w3c.github.io/webrtc-stats/
8*d9f75844SAndroid Build Coastguard Workerand allows querying information about the current state of a RTCPeerConnection
9*d9f75844SAndroid Build Coastguard WorkerAPI and some of its member objects.
10*d9f75844SAndroid Build Coastguard Worker
11*d9f75844SAndroid Build Coastguard Worker## Adding new statistics to Chrome
12*d9f75844SAndroid Build Coastguard Worker
13*d9f75844SAndroid Build Coastguard WorkerWhen adding a new standardized `RTCStatsMember` it is necessary to add
14*d9f75844SAndroid Build Coastguard Workerit to the Chrome allowlist
15*d9f75844SAndroid Build Coastguard Worker  chrome/test/data/webrtc/peerconnection_getstats.js
16*d9f75844SAndroid Build Coastguard Workerbefore landing the WebRTC change. This mechanism prevents the accidential
17*d9f75844SAndroid Build Coastguard Workeraddition and exposure of non-standard attributes and is not required for
18*d9f75844SAndroid Build Coastguard Worker`RTCNonStandardStatsMember` which is not exposed to the web API.