1 /* 2 * libjingle 3 * Copyright 2015 Google Inc. 4 * 5 * Redistribution and use in source and binary forms, with or without 6 * modification, are permitted provided that the following conditions are met: 7 * 8 * 1. Redistributions of source code must retain the above copyright notice, 9 * this list of conditions and the following disclaimer. 10 * 2. Redistributions in binary form must reproduce the above copyright notice, 11 * this list of conditions and the following disclaimer in the documentation 12 * and/or other materials provided with the distribution. 13 * 3. The name of the author may not be used to endorse or promote products 14 * derived from this software without specific prior written permission. 15 * 16 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED 17 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF 18 * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO 19 * EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 20 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, 21 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; 22 * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, 23 * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR 24 * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF 25 * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 26 */ 27 28 package org.webrtc; 29 30 /** Java wrapper for a C++ RtpSenderInterface. */ 31 public class RtpSender { 32 final long nativeRtpSender; 33 34 private MediaStreamTrack cachedTrack; 35 private boolean ownsTrack = true; 36 RtpSender(long nativeRtpSender)37 public RtpSender(long nativeRtpSender) { 38 this.nativeRtpSender = nativeRtpSender; 39 long track = nativeGetTrack(nativeRtpSender); 40 // It may be possible for an RtpSender to be created without a track. 41 cachedTrack = (track == 0) ? null : new MediaStreamTrack(track); 42 } 43 44 // If |takeOwnership| is true, the RtpSender takes ownership of the track 45 // from the caller, and will auto-dispose of it when no longer needed. 46 // |takeOwnership| should only be used if the caller owns the track; it is 47 // not appropriate when the track is owned by, for example, another RtpSender 48 // or a MediaStream. setTrack(MediaStreamTrack track, boolean takeOwnership)49 public boolean setTrack(MediaStreamTrack track, boolean takeOwnership) { 50 if (!nativeSetTrack(nativeRtpSender, 51 (track == null) ? 0 : track.nativeTrack)) { 52 return false; 53 } 54 if (cachedTrack != null && ownsTrack) { 55 cachedTrack.dispose(); 56 } 57 cachedTrack = track; 58 ownsTrack = takeOwnership; 59 return true; 60 } 61 track()62 public MediaStreamTrack track() { 63 return cachedTrack; 64 } 65 id()66 public String id() { 67 return nativeId(nativeRtpSender); 68 } 69 dispose()70 public void dispose() { 71 if (cachedTrack != null && ownsTrack) { 72 cachedTrack.dispose(); 73 } 74 free(nativeRtpSender); 75 } 76 nativeSetTrack(long nativeRtpSender, long nativeTrack)77 private static native boolean nativeSetTrack(long nativeRtpSender, 78 long nativeTrack); 79 80 // This should increment the reference count of the track. 81 // Will be released in dispose() or setTrack(). nativeGetTrack(long nativeRtpSender)82 private static native long nativeGetTrack(long nativeRtpSender); 83 nativeId(long nativeRtpSender)84 private static native String nativeId(long nativeRtpSender); 85 free(long nativeRtpSender)86 private static native void free(long nativeRtpSender); 87 } 88 ; 89