투케이2K

187. (TWOK/LOGIC) [Aws] AWS Kvs HLS 사용해 실시간 비디오 스트리밍 재생 및 앱 입장에서 S3 녹화 영상 업로드 로직 정리

투케이2K — Wed, 13 May 2026 20:39:13 +0900

[로직 정리]

정리 로직 : AWS / Kvs / HLS

제 목 : [Aws] AWS Kvs HLS 사용해 실시간 비디오 스트리밍 재생 및 앱 입장에서 S3 녹화 영상 업로드 로직 정리

[설 명]

// --------------------------------------------------------------------------------------
[사전) 설정 및 정보 확인 사항]
// --------------------------------------------------------------------------------------

1. 제 목 : [Aws] AWS Kvs HLS 사용해 실시간 비디오 스트리밍 재생 및 앱 입장에서 S3 녹화 영상 업로드 로직 정리


2. 테스트 환경 : Aws / Kvs / HLS / S3


3. 사전)   비디오 스트림 간략 설명 정리 : 

  >> 비디오 스트림은 라이브 비디오 및 기타 시간이 인코딩된 데이터를 캡처하고, 선택적으로 저장하고, 실시간, 배치 혹은 애드혹 형식으로 데이터의 소비를 가능하게 할 수 있도록 해 주는 리소스입니다

  >> 일반적인 구성에서는 Kinesis 비디오 스트림은 데이터를 푸시해 주는 생산자가 하나만 있습니다 (실시간 스트리밍 데이터를 밀어 넣어주는 하드웨어 기기)


4. 사전)   HLS 개념 설명 : 

  >> HTTP 라이브 스트리밍으로 인터넷을 통해 소비자에게 미디어 콘텐츠를 제공하는 데 사용되는 스트리밍 프로토콜입니다

  >> HLS 는 Apple 장치에서 지원하는 유일한 형식입니다

  >> 미디어는 h.264 또는 h.265 인코딩된 비디오를 포함해야 하며 AAC 인코딩된 오디오는 선택 사항입니다

  >> 미디어 타입 유효한 값의 예로는 "video/h264" 및 "video/h264,audio/aac" 가 있습니다

// --------------------------------------------------------------------------------------






// --------------------------------------------------------------------------------------
[로직 설명]
// --------------------------------------------------------------------------------------

✅ 사전) 실시간 영상 재생 시 사용 되는 WebRTC 와 HLS 비교 설명 정리

--------------------------------------------------------------
구분          |     WebRTC         |      HLS
--------------------------------------------------------------
핵심 목적     |  초저지연 실시간     | 안정적 스트리밍 & 재생
--------------------------------------------------------------
지연          |     0.3~1초        | 5~30초
--------------------------------------------------------------
대상          | 실시간 상호작용     | 다수 시청, 기록, 재생
--------------------------------------------------------------
네트워크      |    P2P / UDP       | HTTP / CDN
--------------------------------------------------------------
확장성        | 낮음 (연결 수 제한) | ✅ 매우 높음
--------------------------------------------------------------
녹화/보관     |    ❌ 직접 불가    | ✅ 자연스럽게 연계
--------------------------------------------------------------



✅ 흐름 정리) 디바이스 기기 HLS 라이브 스트리밍 재생 및 앱에서 영상 시청 및 녹화 동작 흐름 정리

1. 기기: PutMedia : 스트리밍 데이터 전송 수행

2. 앱: HLS 재생 (보기만)

3. 앱: “녹화 시작” 버튼

4. Backend: 서버 타임스탬프 기록

5. 앱: “녹화 종료”

6. Backend:
   - 시간 범위 계산
   - ListFragments
   - GetMediaForFragmentList / GetClip
   - S3 저장



✅ 세부 정리) 각 흐름 단계에서 세부 사항 정리

1. 기기: PutMedia : 스트리밍 데이터 전송 수행

  >> 기기는 영상 원본을 KVS로 지속적으로 푸시

  >> Stream retention 반드시 > 0 : 최소 1시간 (실무에선 24h~72h 흔함)

  >> Fragment duration : 보통 2~6초 : 나중에 “구간 자르기” 정확도에 영향

2. 앱: HLS 재생 (보기만)

  >> 사용자는 실시간 또는 약간 지연된 영상 시청

  >> 앱은 GetHLSStreamingSessionURL로 m3u8 URL 획득

  >> 실제 영상은 KVS 내부 fragment를 읽어서 제공

3. 앱: “녹화 시작” 버튼

  >> 백엔드에 API 호출 : 이 시점부터의 시간을 기록해라

4. Backend: 서버 타임스탬프 기록

  >> 백엔드는 녹화 요청이 들어온 타임 스탬프 값 시간을 저장

5. 앱: “녹화 종료”

  >> 백엔드에 API 호출 : 녹화 영상 종료 시간을 기록해라

6-1. Backend: 시간 범위 계산

  >> 녹화 시작 타임스탬프, 녹화 종료 타임스탬프 확인

6-2. GetClip vs GetMediaForFragmentList 선택

  >>   GetClip (가장 간단)

    - 쓰임 : 사용자 버튼 녹화 , 수 초 ~ 수 분 , “파일 하나면 충분”

        $ 안정적으로 쓰이는 범위 : 수 초 ~ 수 분 , 일반적으로 1~5분 , 길어도 10분 전후

    - 동작 : 

      TimestampRange
        → KVS가 자동으로 fragment 선택
        → MP4 파일 생성
        → 스트리밍 응답

    - 장점 : 구현 쉬움 , 추가 처리 거의 없음

    - 단점 : 대용량 부적합 , 세밀한 제어 불가

  >>   ListFragments + GetMediaForFragmentList (정석)

    - 쓰임 : 자동 녹화 , 장시간 , 분석 / 후처리 필요 , 대규모 시스템

    - 동작 : 

      TimestampRange
        → ListFragments (fragment 번호 목록)
        → GetMediaForFragmentList (MKV payload)
        → (필요시 변환)
        → S3

    - 장점 : 제어력 100% , 확장성 좋음

    - 단점 : 구현 복잡 , 후처리 필요

6-3. S3 저장

  >> 저장 형태 : 
  
    - GetClip → MP4 바로 업로드
    - Fragment 방식 → 변환 후 MP4 / 그대로 MKV

// --------------------------------------------------------------------------------------






// --------------------------------------------------------------------------------------
[참고 사이트]
// --------------------------------------------------------------------------------------

▶️ 143. (TWOK/LOGIC) [android] Aws Kvs HLS PutMedia 스트리밍 동영상 업로드 로직 정리 - DataEndpoint, MKV , AWS4Signer

https://kkh0977.tistory.com/8013

https://blog.naver.com/kkh0977/223875616765?trackingCode=blog_bloghome_searchlist


▶️ 145. (TWOK/LOGIC) [Aws] Aws Kvs HLS 디바이스 카메라 라이브 스트리밍 정보 PutMedia 업로드 방법 로직 정리

https://kkh0977.tistory.com/8086

https://blog.naver.com/kkh0977/223911555706?trackingCode=blog_bloghome_searchlist


▶️ 146. (TWOK/LOGIC) [Aws] Kvs HLS 라이브 스트리밍 로컬 PC에서 업로드 하기 위한 프로세스 로직 정리 - aws , ffmpeg , gstreamer 사용

https://kkh0977.tistory.com/8099

https://blog.naver.com/kkh0977/223918332596?trackingCode=blog_bloghome_searchlist


▶️ 147. (TWOK/LOGIC) [android] 안드로이드 휴대폰 실시간 카메라 스트림 영상을 마스터 역할로 Aws Kvs HLS 라이브 스트리밍 업로드 로직 정리

https://kkh0977.tistory.com/8250

https://blog.naver.com/kkh0977/223996783911?trackingCode=blog_bloghome_searchlist


▶️ 153. (TWOK/LOGIC) [Aws] 자바스크립트 Aws Kvs HLS 비디오 라이브 스트리밍 뷰어 Viewer 영상 재생 방법 정리

https://kkh0977.tistory.com/8405

https://blog.naver.com/kkh0977/224079078341?trackingCode=blog_bloghome_searchlist


▶️ AWS : ListFragments 설명

https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_reader_ListFragments.html


▶️ AWS : GetMediaForFragmentList 설명

https://docs.aws.amazon.com/ko_kr/kinesisvideostreams/latest/dg/API_reader_GetMediaForFragmentList.html


▶️ AWS : GetClip 설명

https://docs.aws.amazon.com/ko_kr/kinesisvideostreams/latest/dg/API_reader_GetClip.html

// --------------------------------------------------------------------------------------

[참고 사이트]

https://kkh0977.tistory.com/8013

143. (TWOK/LOGIC) [android] Aws Kvs HLS PutMedia 스트리밍 동영상 업로드 로직 정리 - DataEndpoint, MKV , AWS4Signer

[로직 정리]정리 로직 : Mobile상태 : [android] Aws Kvs HLS PutMedia 스트리밍 동영상 업로드 로직 정리 - DataEndpoint, MKV , AWS4Signer [설 명]// ------------------------------------------------------------------------------

kkh0977.tistory.com

1054. (Android/Java) [개념 정리] 안드로이드 build.gradle signingConfigs ' 앱 서명 하기 위한 키 정보 정의 영역 ' 설명 정리

투케이2K — Wed, 13 May 2026 20:32:40 +0900

[개발 환경 설정]

개발 툴 : AndroidStudio

개발 언어 : Java / Kotlin

[소스 코드]

// --------------------------------------------------------------------------------------
[개발 및 테스트 환경]
// --------------------------------------------------------------------------------------

- 언어 : Java / Kotlin


- 개발 툴 : AndroidStudio


- 기술 구분 : Android / build.gradle / signingConfigs


- 사전)   APK (Android Application Package) 파일 간략 설명

  >> APK 는 안드로이드 앱을 설치하기 위한 배포 파일 형식입니다.

    - PC 에서의 .exe, iOS의 .ipa와 같은 역할을 합니다.

  >> APK 파일 하나에 앱 실행에 필요한 모든 것이 포함되어 있습니다.

    - 앱 코드 (Java / Kotlin → DEX)
    - UI 리소스 (XML, 이미지, 문자열)
    - 앱 설정 (AndroidManifest.xml)
    - 서명 정보 (인증서)

  >> APK 내부 구조 (중요) : APK 는 사실상 ZIP 파일입니다. (확장자만 .apk)

    app.apk
    ├─ AndroidManifest.xml : 앱의 기본 정보 (패키지명, 권한, Activity 등)
    ├─ classes.dex : 앱 실행 코드 (Dalvik/ART용 바이트코드)
    ├─ resources.arsc 
    ├─ res/ : 레이아웃, 아이콘, 문자열
    ├─ assets/ : 그대로 사용하는 리소스
    ├─ lib/ : 네이티브 라이브러리 (.so)
    └─ META-INF/ : 서명정보 (매우 중요)

// --------------------------------------------------------------------------------------






// --------------------------------------------------------------------------------------
[설명 정리]
// --------------------------------------------------------------------------------------

1. ✅ 안드로이드 build.gradle signingConfigs 는 앱을 서명 (Signing) 하기 위한 키 정보들을 정의하는 영역입니다.

  >>   안드로이드 앱은 반드시 서명되어야만 설치·배포가 가능하며, signingConfigs는 그 서명에 필요한 keystore와 키 설정을 미리 선언하는 역할을 합니다.


2. 안드로이드 signingConfigs 가 필요한 이유 : 

  >> 디바이스에 설치할 때

  >> Google Play에 배포할 때

  >> 업데이트(같은 키로 서명해야 함)

  >>   서명 키가 바뀌면 기존 앱을 업데이트할 수 없기 때문에, 서명 정보는 매우 중요하며 build 설정에 명확히 정의해야 합니다.


3. 안드로이드 signingConfigs 선언 위치 : 보통 모듈 레벨(app/build.gradle)의 android {} 블록 안에 위치합니다.

  >>   간단 영역 축약 표시

    android {
        signingConfigs {
            ...
        }
    }

  >>   전체 영역 확장 표시

    android {
        namespace "com.twok.app"
        compileSdk 35

        defaultConfig {
            applicationId "com.twok.app"
            minSdkVersion 26
            targetSdk 35

            // 코틀린 이슈[minSdkVersion 20 이하 "AndroidX를 사용하지 않는" 경우]
            multiDexEnabled true

            // ----------------------------------------
            // TODO 앱 업데이트 시 해당 값 중요
            // ----------------------------------------
            versionCode = 38 // 해당 값 중요 > 앱 업데이트 판단
            versionName = "2.5.2"
            // ----------------------------------------
        }

        // ✅ 키스토어 설정 정보
        signingConfigs {
            release {
                storeFile file("signature/keystore") // TODO Project >> app >> signature 폴더 >> keystore 파일 첨부 시 경로
                storePassword "twok1234"
                keyAlias "twok2k"
                keyPassword "twok1234"
            }
            debug {
                storeFile file('../keystore') // TODO Project >> keystore 파일 첨부 시 경로
                storePassword "twok1234"
                keyAlias "twok2k"
                keyPassword "twok1234"
            }
        }

    }


4. 안드로이드 signingConfigs 내에 선언 되는 각 항목 의미 설명 : 

  >> storeFile : keystore 파일 경로 (.jks 또는 .keystore)

  >> storePassword : keystore 비밀번호

  >> keyAlias : keystore 안의 키 별칭

  >> keyPassword : 해당 키의 비밀번호


5. 안드로이드 signingConfigs 내에 debug 서명과 release 서명의 차이

  >> debug 서명 : 

    - Android Studio 가 자동 생성
    - 개발 & 테스트용

  >> release 서명 : 

    - 직접 생성한 keystore 사용
    - 앱 스토어 배포용


6. ✅ signingConfigs 와 buildTypes 의 연결 예시 

  >>   signingConfigs는 정의만 하는 영역이고, 실제로 어떤 빌드에 사용할지는 buildTypes에서 지정합니다.
  
    android {
        signingConfigs {
            release {
                storeFile file("release.jks")
                storePassword "password"
                keyAlias "release"
                keyPassword "password"
            }
        }

        buildTypes {
            release {
                signingConfig signingConfigs.release
                minifyEnabled true
            }
        }
    }

// --------------------------------------------------------------------------------------





// --------------------------------------------------------------------------------------
[참고 사이트]
// --------------------------------------------------------------------------------------

▶️ [Android] [출처 알 수 없는 앱 설치 허용] 앱 업데이트 여부 판단 및 앱 업데이트 수행 실시 - vnd.package-archive

https://kkh0977.tistory.com/4842

https://blog.naver.com/kkh0977/223258123850?trackingCode=blog_bloghome_searchlist


▶️ [안드로이드 키툴 (Keytool) 사용해 apk 실행 파일 앱 서명 정보 확인 방법]

https://kkh0977.tistory.com/6834

https://blog.naver.com/kkh0977/223550265510?trackingCode=blog_bloghome_searchlist


▶️ [안드로이드 apksigner 사용해 특정 apk 파일 jks , keystore 서명 인증 수행]

https://kkh0977.tistory.com/6973

https://blog.naver.com/kkh0977/223582075557?trackingCode=blog_bloghome_searchlist


▶️ [안드로이드 apksigner 사용해 특정 apk 파일 서명 인증 타입 확인 수행 (v1 , v2)]

https://kkh0977.tistory.com/6972

https://blog.naver.com/kkh0977/223582072292?trackingCode=blog_bloghome_searchlist


▶️ [업무 이슈] 안드로이드 apk 파일 빌드 시 필요한 jks 파일 alias 명칭 초기화 및 잊어 버림 이슈

https://kkh0977.tistory.com/7197

https://blog.naver.com/kkh0977/223626175927?trackingCode=blog_bloghome_searchlist


▶️ [업무 이슈] 삼성 갤럭 시 스마트폰 apk 파일 설치 시 보이스 피싱 의심 앱 설치 불가 문의 - 무시하고 설치 버튼 미표시

https://kkh0977.tistory.com/7974

https://blog.naver.com/kkh0977/223828837077?trackingCode=blog_bloghome_searchlist


▶️ [IT 정보] 구글 플레이 프로텍트 (Google Play Protect) 사용 해제 및 apk 파일 무시하고 설치 방법 (알 수 없는 앱 설치)

https://kkh0977.tistory.com/6333

https://blog.naver.com/kkh0977/223469956481?trackingCode=blog_bloghome_searchlist

// --------------------------------------------------------------------------------------

[참고 사이트]

https://kkh0977.tistory.com/4842

36. (TWOK/LOGIC) [Android] [출처 알 수 없는 앱 설치 허용] 앱 업데이트 여부 판단 및 앱 업데이트 수행

[로직 정리] 정리 로직 : Android 상태 : [Android] [출처 알 수 없는 앱 설치 허용] 앱 업데이트 여부 판단 및 앱 업데이트 수행 실시 - vnd.package-archive [설 명] [1] : 알수 없는 앱 설치 권한 부여 상

kkh0977.tistory.com

329. [IT 용어] ThingPlug ( 씽플러그 ) ' IoT 디바이스를 네트워크에 연결하고 데이터를 수집·관리·분석할 수 있도록 해주는 클라우드 기반 서비스 ' 용어 설명

투케이2K — Tue, 12 May 2026 19:54:03 +0900

[타이틀]

주제 : [IT 용어]

제목 : [IT 용어] ThingPlug ( 씽플러그 ) ' IoT 디바이스를 네트워크에 연결하고 데이터를 수집·관리·분석할 수 있도록 해주는 클라우드 기반 서비스 ' 용어 설명

[설 명]

// --------------------------------------------------------------------------------------
[IT 정보 및 환경]
// --------------------------------------------------------------------------------------

구분 : IT 용어 설명


제목 : [IT 용어] ThingPlug ( 씽플러그 ) ' IoT 디바이스를 네트워크에 연결하고 데이터를 수집·관리·분석할 수 있도록 해주는 클라우드 기반 서비스 ' 용어 설명


기술 : IT 용어 / ThingPlug / 씽플러그


사전)   IoT 장비 간략 설명 : 

  >> IoT 장비 (사물인터넷, Internet of Things Device) 는 인터넷에 연결되어 데이터를 수집·전송·처리하고, 다른 시스템이나 사람과 상호작용하는 물리적 장치를 말합니다.

  >> IoT 장비의 기본 구성요소 : 

    - 센서 (Sensor) : 온도, 습도, 조도, 가속도, 압력, 위치(GPS) 등 주변 환경이나 상태를 측정
    - 액추에이터 (Actuator) : 명령에 따라 물리적 동작 수행
    - 프로세서 / MCU : 센서 데이터 처리 및 로직 수행
    - 통신 모듈 : 데이터를 외부로 전송하거나 명령을 수신
    - 전원 : 배터리, 어댑터, 태양광 등

  >> IoT 장비 주요 특징 : 

    - 실시간 데이터 수집
    - 원격 모니터링 및 제어
    - 자동화 및 지능화
    - 24/7 지속적 운영
    - 대규모 확장 가능성(수천~수백만 대)

  >> IoT 장비의 동작 흐름 예시 : 

    - 센서 → IoT 장비 → 네트워크 → 서버/클라우드 → 분석/저장 → 사용자 앱

// --------------------------------------------------------------------------------------





// --------------------------------------------------------------------------------------
[설 명]
// --------------------------------------------------------------------------------------

1. ✅ ThingPlug (씽플러그) 는 IoT(사물인터넷) 플랫폼으로, 다양한 IoT 디바이스를 네트워크에 연결하고 데이터를 수집·관리·분석할 수 있도록 해주는 클라우드 기반 서비스입니다.

  >>   기업(B2B) 및 공공, 산업용 IoT 구축에 주로 활용됩니다.


2. ThingPlug (씽플러그) 는 디바이스–네트워크–플랫폼–애플리케이션을 하나로 연결해 주는 IoT 중간 플랫폼 (Middleware) 역할을 수행합니다.

  >>   개발자는 통신, 인증, 메시지 처리 같은 복잡한 부분을 직접 구현하지 않고도 IoT 서비스를 빠르게 만들 수 있습니다.


3. ✅ ThingPlug (씽플러그) 주요 기능 : 

  >> 디바이스 관리 : 

    - 센서, 게이트웨이, 단말 등록/삭제
    - 디바이스 상태 모니터링
    - 원격 제어 및 펌웨어 업데이트(OTA)

  >> 통신 및 연결 : 

    - LTE-M, NB-IoT, 5G 등 SKT 이동통신망 연동
    - MQTT, HTTP, CoAP 같은 IoT 표준 프로토콜 지원
    - 대규모 디바이스 동시 연결 처리

  >> 데이터 수집·처리 : 

    - 실시간 데이터 수집
    - 규칙(Rule) 엔진 및 이벤트 처리
    - 외부 시스템(서버, 클라우드, 빅데이터 플랫폼) 연동 API 제공

  >> 보안 : 
  
    - 디바이스 인증 및 접근 제어
    - 암호화 통신
    - 플랫폼 단 보안 정책 관리

  >> 서비스 개발 지원 : 

    - REST API 제공
    - 대시보드 및 모니터링 기능
    - 다양한 산업에 적용 가능한 레퍼런스 아키텍처


4. ThingPlug (씽플러그) 적용 분야 : 

  >> 스마트 시티 : 가로등, 주차, 환경센서

  >> 스마트 팩토리 : 설비 모니터링, 예지보전

  >> 물류/유통 : 자산 추적, 콜드체인

  >> 에너지 : 스마트 미터링, 전력 관리

  >> 헬스케어 : 웨어러블, 원격 모니터링

  >> 보안/안전 : CCTV 연동, 재난 감지


5. ✅ ThingPlug (씽플러그) 장점 : 

  >> 통신사 플랫폼 : SKT 네트워크와의 강력한 연계

  >> 대규모 확장성 : 수만~수백만 디바이스 관리 가능

  >> 빠른 서비스 출시 : IoT 공통 기능을 이미 제공

  >> 국내 환경 최적화 : 국내 통신·규제·산업 환경에 적합

// --------------------------------------------------------------------------------------





// --------------------------------------------------------------------------------------
[참고 사이트]
// --------------------------------------------------------------------------------------

▶️ [IT 용어] 프리뷰 ( Preview ) ' 콘텐츠를 열기 전에 일부 내용을 미리 보여주는 기능이나 화면 ' 용어 설명

https://kkh0977.tistory.com/8808

https://blog.naver.com/kkh0977/224279251903


▶️ [IT 용어] 패스키 ( Passkey ) ' 비밀번호 입력 대체 로그인 인증 방식 ' 용어 설명

https://kkh0977.tistory.com/8804

https://blog.naver.com/kkh0977/224276890259


▶️ [IT 용어] 프라이버시 마스킹 ( Privacy Masking ) ' 개인정보 를 그대로 노출하지 않고 일부를 가리거나 변형해서 보호하는 기술 ' 용어 설명 정리

https://kkh0977.tistory.com/8802

https://blog.naver.com/kkh0977/224274896785


▶️ [IT 용어] SID ( Security Identifier ) ' 보안 식별자 ' 용어 설명 정리

https://kkh0977.tistory.com/8791

https://blog.naver.com/kkh0977/224268449117


▶️ [IT 용어] PbD 개인정보보호 중심 설계 설명

https://kkh0977.tistory.com/5491

https://blog.naver.com/kkh0977/223359791382?trackingCode=blog_bloghome_searchlist


▶️ [CI , DI 용어 설명 - 개인 식별 정보]

https://kkh0977.tistory.com/5246

https://blog.naver.com/kkh0977/223334171115?trackingCode=blog_bloghome_searchlist

// --------------------------------------------------------------------------------------

[참고 사이트]

https://kkh0977.tistory.com/8808

328. [IT 용어] 프리뷰 ( Preview ) ' 콘텐츠를 열기 전에 일부 내용을 미리 보여주는 기능이나 화면 '

[타이틀]주제 : [IT 용어]제목 : [IT 용어] 프리뷰 ( Preview ) ' 콘텐츠를 열기 전에 일부 내용을 미리 보여주는 기능이나 화면 ' 용어 설명 [설 명]// --------------------------------------------------------

kkh0977.tistory.com

54. (ADB/Command) adb package 와 dumpsys 명령어 사용해 내 휴대폰에 설치 된 특정 앱 패키지 명칭 및 앱 정보 확인 수행

투케이2K — Tue, 12 May 2026 19:48:07 +0900

[환경 구성 및 요약 설명]

개발 환경 : Mobile / Android / ADB Shell

제목 및 설명 : adb package 와 dumpsys 명령어 사용해 내 휴대폰에 설치 된 특정 앱 패키지 명칭 및 앱 정보 확인 수행

[설 명]

// --------------------------------------------------------------------------------------
[개발 및 테스트 환경]
// --------------------------------------------------------------------------------------

- 개발 툴 : ADB Shell


- 환 경 : 안드로이드 (Android) / 모바일 (Mobile)


- 사전)   ADB 간략 설명 정리 : 

  >> ADB 는 PC에서 안드로이드 기기를 제어·디버깅·관리하기 위한 공식 도구입니다.

  >> ADB 는 Android SDK (플랫폼 도구) 에 포함되어 있으며, USB 또는 Wi‑Fi로 기기와 연결해 다양한 명령을 실행할 수 있습니다.


- 사전)   ADB 사용 참고 사항 : 

  >> ADB 설치 후 휴대폰 개발자 모드 활성 및 USB 디버깅 허용이 필요합니다

  >> GitBash 또는 CMD 명령 프롬프트에서 간편히 ADB 명령어를 사용하기 위해서는 환경 변수 추가 설정이 필요합니다.

  >> 필요 시 USB 드라이브 별도 설치 진행이 필요합니다

// --------------------------------------------------------------------------------------






// --------------------------------------------------------------------------------------
[내용 정리]
// --------------------------------------------------------------------------------------

1. 설 명 : adb package 와 dumpsys 명령어 사용해 내 휴대폰에 설치 된 특정 앱 패키지 명칭 및 앱 정보를 확인할 수 있습니다.


2. ✅ 문 법 : 패키지 명칭 확인

  >> 전체 패키지 리스트 출력 : $ adb shell pm list package
  
  >> 특정 패키지 명칭 단어 알고 있는 경우 (twokapp) : $ adb shell pm list package | findstr twokapp

  >> 결과 출력 : package:com.test.twokapp


3. ✅ 문 법 : 특정 앱 파일 정보 확인 (패키지 명칭 필요)

  >> 전체 정보 출력 : $ adb shell dumpsys package package:com.test.twokapp

  >> 인증서 정보 확인 : $ adb shell dumpsys package package:com.test.twokapp | findstr Sign

  >> 결과 출력 : 

      Signatures: [8A:31:...:8B:7B]
      Signing KeySets: 218
    apkSigningVersion=2
    signatures=PackageSignatures{7d700ac version:2, signatures:[..], past signatures:[]}


4. ✅ 참고 사항 : 

  >> 특정 앱 정보를 확인하기 위해서는 휴대폰에 특정 앱이 설치되어 있어야합니다.

// -----------------------------------------------------------------------------------






// --------------------------------------------------------------------------------------
[참고 사이트]
// --------------------------------------------------------------------------------------

▶️ [Android Debug Bridge 안드로이드 디버그 브리지 설치 방법 참고 사이트]

https://kkh0977.tistory.com/5315

https://blog.naver.com/kkh0977/223341714062


▶️ [Window] 윈도우 안드로이드 adb 설치 확인 및 환경 변수 설정 , adb version 버전 확인 실시

https://kkh0977.tistory.com/3344

https://blog.naver.com/kkh0977/222940534941?trackingCode=blog_bloghome_searchlist


▶️ [설치된 ADB 버전 확인 수행]

https://kkh0977.tistory.com/5369

https://blog.naver.com/kkh0977/223345012805


▶️ [현재 디버깅 연결 된 안드로이드 기기 확인 방법]

https://kkh0977.tistory.com/5370

https://blog.naver.com/kkh0977/223345015247

// --------------------------------------------------------------------------------------

[참고 사이트]

https://kkh0977.tistory.com/5315

1. (ADB) Android Debug Bridge 안드로이드 디버그 브리지 설치 방법 참고 사이트

[환경 구성 및 요약 설명] Mobile : Android 설 명 : Android Debug Bridge 안드로이드 디버그 브리지 설치 방법 참고 사이트 [설 명] -----------------------------------------------------------------------------------------

kkh0977.tistory.com

212. (TWOK/WORK) [업무 이슈] 안드로이드 apk 앱 설치 파일 설치 수행 시 ' 패키지가 충돌했습니다. ' , ' 앱이 설치되지 않았습니다 ' 메시지 표시 이슈

투케이2K — Tue, 12 May 2026 19:39:56 +0900

[제 목]

주제 : 투케이2K 업무 정리

타이틀 : 투케이 / 2k / 업무 정리

제목 : [업무 이슈] 안드로이드 apk 앱 설치 파일 설치 수행 시 ' 패키지가 충돌했습니다. ' , ' 앱이 설치되지 않았습니다 ' 메시지 표시 이슈

[내 용]

------------------------------------------------------------------------------
[개발 및 테스트 환경]
------------------------------------------------------------------------------

- 제 목 : [업무 이슈] 안드로이드 apk 앱 설치 파일 설치 수행 시 ' 패키지가 충돌했습니다. ' , ' 앱이 설치되지 않았습니다 ' 메시지 표시 이슈


- 테스트 환경 : Mobile / Android / APK


- 사전)   APK (Android Application Package) 파일 간략 설명

  >> APK 는 안드로이드 앱을 설치하기 위한 배포 파일 형식입니다.

    - PC 에서의 .exe, iOS의 .ipa와 같은 역할을 합니다.

  >> APK 파일 하나에 앱 실행에 필요한 모든 것이 포함되어 있습니다.

    - 앱 코드 (Java / Kotlin → DEX)
    - UI 리소스 (XML, 이미지, 문자열)
    - 앱 설정 (AndroidManifest.xml)
    - 서명 정보 (인증서)

  >> APK 내부 구조 (중요) : APK 는 사실상 ZIP 파일입니다. (확장자만 .apk)

    app.apk
    ├─ AndroidManifest.xml : 앱의 기본 정보 (패키지명, 권한, Activity 등)
    ├─ classes.dex : 앱 실행 코드 (Dalvik/ART용 바이트코드)
    ├─ resources.arsc 
    ├─ res/ : 레이아웃, 아이콘, 문자열
    ├─ assets/ : 그대로 사용하는 리소스
    ├─ lib/ : 네이티브 라이브러리 (.so)
    └─ META-INF/ : 서명정보 (매우 중요)

------------------------------------------------------------------------------





------------------------------------------------------------------------------
[이슈 사항]
------------------------------------------------------------------------------

1. 안드로이드 특정 앱에서 ' 출처를 알 수 없는 앱 설치 ' 권한 부여 후 APK 파일 설치 및 업데이트 진행 시 

  ❌ ' 패키지가 충돌했습니다. ' 

  ❌ ' 앱이 설치되지 않았습니다 ' 
  
  메시지가 표시 이슈 문의


2. 사전 앱 조건 설명)

  >> 앱에는 출처를 알 수 없는 앱 설치 권한 부여 된 상태

  >> 기존 APK 파일에서 새로운 버전 앱 파일 업데이트 수행 시 위와 같은 에러 메시지가 표시 되는 이슈

------------------------------------------------------------------------------





------------------------------------------------------------------------------
[원인 파악 및 증상 재현]
------------------------------------------------------------------------------

1. 기존 앱 배포 사이트에 올라가져 있는 APK 파일 다운로드 수행


2. 휴대폰에 APK 파일 설치 진행


3. 앱 배포 사이트에 새로운 신규 버전 앱 파일 업로드 수행


4. 특정 앱 실행 후 자동으로 앱 업데이트 알림 팝업창이 표시 되는 것 확인


5. 앱 업데이트 진행 버튼 클릭


6. 앱 설치 진행 중에 ❌ ' 패키지가 충돌했습니다. '  , ❌ ' 앱이 설치되지 않았습니다 ' 메시지가 표시 되는 것 확인


7. ✅ 변경 된 사항 확인 시 Git 에 업로드 된 소스 코드는 동일하지만 build.gradle 파일에서 release , debug 에 사용 되는 signingConfigs 값이 기존과 다른 것 확인

  >> 기존 앱 파일과 사인 된 값이 달라서 위와 같은 에러 메시지가 표시 되는 것 확인

  >> ✔️ 안드로이드 키툴 (Keytool) 사용해 apk 파일 앱 서명 정보 확인 시 기존 설치 된 APK 파일과 신규로 설치하려는 APK 파일 인증서 지문 정보가 다른 것 확인

------------------------------------------------------------------------------






------------------------------------------------------------------------------
[조치 내용]
------------------------------------------------------------------------------

1. build.gradle 파일에서 앱 빌드 시 사용 된 jks 및 keystore 정보를 기존 앱과 동일하게 설정 수행

  android {
      namespace "com.twok.app"
      compileSdk 35

      defaultConfig {
          applicationId "com.twok.app"
          minSdkVersion 26
          targetSdk 35

          // 코틀린 이슈[minSdkVersion 20 이하 "AndroidX를 사용하지 않는" 경우]
          multiDexEnabled true

          // ----------------------------------------
          // TODO 앱 업데이트 시 해당 값 중요
          // ----------------------------------------
          versionCode = 38 // 해당 값 중요 > 앱 업데이트 판단
          versionName = "2.5.2"
          // ----------------------------------------
      }

      // ✅ 키스토어 설정 정보
      signingConfigs {
          release {
              storeFile file("signature/keystore") // TODO Project >> app >> signature 폴더 >> keystore 파일 첨부 시 경로
              storePassword "twok1234"
              keyAlias "twok2k"
              keyPassword "twok1234"
          }
          debug {
              storeFile file('../keystore') // TODO Project >> keystore 파일 첨부 시 경로
              storePassword "twok1234"
              keyAlias "twok2k"
              keyPassword "twok1234"
          }
      }

  }


2. 앱 프로젝트 build.gradle sync 동기화 수행 후 다시 앱 재빌드 수행 실시


3. 재빌드 된 APK 앱 파일 다시 설치 진행 시 정상적으로 앱이 신규 버전으로 업데이트 되는 것 확인


4. ✅ 추가) ❌ ' 패키지가 충돌했습니다. '  , ❌ ' 앱이 설치되지 않았습니다 ' 메시지가 표시 될 수 있는 추가 상황 정리

  >> ✔️ 이미 기기에 설치된 앱과 지금 설치하려는 APK 서명키가 다른 경우 문제 발생

    - Android 보안 정책상 서명이 다르면 “업데이트” 불가 >> 그래서 “패키지 충돌” 발생

  >> ✔️ Play Store 에 설치된 앱이 있는데, 로컬 APK 설치 시 문제 발생

    - Play Store 앱 → Google App Signing 키 / 개발 PC APK → 로컬 keystore   키가 다르므로 충돌 발생 가능

  >> ✔️ OS 제조사 커스텀 APK 

    - 시스템 앱으로 사전 설치됨 >> 동일 패키지명 앱 설치 시 충돌

------------------------------------------------------------------------------





------------------------------------------------------------------------------
[참고 사이트]
------------------------------------------------------------------------------

▶️ [Android] [출처 알 수 없는 앱 설치 허용] 앱 업데이트 여부 판단 및 앱 업데이트 수행 실시 - vnd.package-archive

https://kkh0977.tistory.com/4842

https://blog.naver.com/kkh0977/223258123850?trackingCode=blog_bloghome_searchlist


▶️ [안드로이드 키툴 (Keytool) 사용해 apk 실행 파일 앱 서명 정보 확인 방법]

https://kkh0977.tistory.com/6834

https://blog.naver.com/kkh0977/223550265510?trackingCode=blog_bloghome_searchlist


▶️ [안드로이드 apksigner 사용해 특정 apk 파일 jks , keystore 서명 인증 수행]

https://kkh0977.tistory.com/6973

https://blog.naver.com/kkh0977/223582075557?trackingCode=blog_bloghome_searchlist


▶️ [안드로이드 apksigner 사용해 특정 apk 파일 서명 인증 타입 확인 수행 (v1 , v2)]

https://kkh0977.tistory.com/6972

https://blog.naver.com/kkh0977/223582072292?trackingCode=blog_bloghome_searchlist


▶️ [업무 이슈] 안드로이드 apk 파일 빌드 시 필요한 jks 파일 alias 명칭 초기화 및 잊어 버림 이슈

https://kkh0977.tistory.com/7197

https://blog.naver.com/kkh0977/223626175927?trackingCode=blog_bloghome_searchlist


▶️ [업무 이슈] 삼성 갤럭 시 스마트폰 apk 파일 설치 시 보이스 피싱 의심 앱 설치 불가 문의 - 무시하고 설치 버튼 미표시

https://kkh0977.tistory.com/7974

https://blog.naver.com/kkh0977/223828837077?trackingCode=blog_bloghome_searchlist


▶️ [IT 정보] 구글 플레이 프로텍트 (Google Play Protect) 사용 해제 및 apk 파일 무시하고 설치 방법 (알 수 없는 앱 설치)

https://kkh0977.tistory.com/6333

https://blog.naver.com/kkh0977/223469956481?trackingCode=blog_bloghome_searchlist

------------------------------------------------------------------------------

[참고 사이트]

https://kkh0977.tistory.com/4842

36. (TWOK/LOGIC) [Android] [출처 알 수 없는 앱 설치 허용] 앱 업데이트 여부 판단 및 앱 업데이트 수행

kkh0977.tistory.com

37. (cmd/명령어) Window Cmd 명령 프롬프트 nslookup 도메인에서 IP 주소 변환 시 문제가 발생하는 경우 확인 방법 정리

투케이2K — Mon, 11 May 2026 19:52:30 +0900

[환경 구성 및 요약 설명]

개발 환경 : Window / Cmd / 터미널

설 명 : Window Cmd 명령 프롬프트 nslookup 도메인에서 IP 주소 변환 시 문제가 발생하는 경우 확인 방법 정리

[소스 코드]

------------------------------------------------------------------------------
[테스트 사항 및 환경]
------------------------------------------------------------------------------

환 경 : 로컬 Window PC / Cmd / 명령 프롬프트


제 목 : Window Cmd 명령 프롬프트 네트워크 상태 확인 명령어 종류 정리 - 기본연결 , 포트 및 연결 , DNS 이름해석 , 로컬 네트워크


사전)   cd (change directory) 명령어 간략 설명 : 

  >> cd 는 Change Directory의 약자로, CMD(명령 프롬프트)에서 현재 작업 중인 디렉터리(폴더)를 변경할 때 사용하는 명령어입니다.

  >> cd 는 '어떤 경로로 이동할 것인가' 를 지정하는 명령어입니다.

  >> 기본 사용 방법 : 

    - 문법 : cd 경로
    - 예시 : cd C:\Wind

------------------------------------------------------------------------------





------------------------------------------------------------------------------
[설 명]
------------------------------------------------------------------------------

-------------------------------------------------
✅ DNS / 이름 해석 확인
-------------------------------------------------

✔️ nslookup : 도메인 → IP 주소 변환 확인 (DNS 확인) / DNS 서버 문제 분석에 필수

  >> nslookup www.naver.com

-------------------------------------------------



-------------------------------------------------
✅ nslookup 호출 시 문제가 발생한 경우 확인 사항 정리
-------------------------------------------------

✔️ DNS 문제인지 먼저 판별 

  >> *** www.google.com을(를) 찾을 수 없습니다: Non-existent domain
     DNS request timed out.
     Server: UnKnown

  >> ping 8.8.8.8 →   성공
     ping www.google.com → ❌ 실패

     IP 통신은 되는데 도메인만 안 됨 = DNS 문제 확정


✔️ DNS 캐시 초기화 (가장 먼저 해볼 것)

  >> 로컬에 깨진 DNS 캐시가 남아 있는 경우 이 한 번으로 해결되는 경우 많음

  >> ipconfig /flushdns  


✔️ DNS 서버 설정 확인 및 변경

  >> DNS Servers 항목 , 비정상 / 사내 내부 DNS만 설정되어 있는지 확인

  >> ipconfig /all


✔️ 임시로 공용 DNS로 변경 (테스트용)

  >> CMD (관리자) 에서 해당 명령 수행하고, 정상되면 회사 DNS 서버 장애 확정

  >> netsh interface ip set dns "이더넷" static 8.8.8.8


✔️ 라우터/게이트웨이 DNS 중계 문제 확인

  >> nslookup www.google.com 게이트웨이IP

  >> nslookup www.google.com 192.168.0.1

  ❌ 실패 : 공유기 DNS 포워딩 문제
  
    성공 : PC DNS 설정 문제


✔️ 방화벽 / 보안 솔루션 확인 (회사 환경 중요)

  >> DNS 는 UDP/TCP 53번 포트 사용

  >> 사내 방화벽 정책 확인

  >> NAC / VPN 접속 상태 확인

  >> 보안 에이전트 설치 후 발생 여부 확인

  >> netsh advfirewall set allprofiles state off 

    -   테스트 후 반드시 다시 ON


✔️ 네트워크 리셋 (최후 수단) : 재부팅 필요

  >> netsh int ip reset

  >> netsh winsock reset

-------------------------------------------------



-------------------------------------------------
✅ 상황별 원인 → 조치 요약표
-------------------------------------------------
    상황      |      원인     |       조치
-------------------------------------------------
IP ping OK 
/ 도메인 X    |  DNS 서버 장애 |   공용 DNS 사용
-------------------------------------------------
nslookup
8.8.8.8 OK   | 사내 DNS 장애  | DNS 서버팀 문의
-------------------------------------------------
모든 nslookup 
    실패      | 방화벽/NAC    | 보안 정책 확인
-------------------------------------------------
간헐적 실패   | DNS 캐시 오류  | flushdns
-------------------------------------------------
공유기만 실패 | 라우터 설정    | 재부팅 / 설정 수정
-------------------------------------------------

------------------------------------------------------------------------------





------------------------------------------------------------------------------
[참고 사이트]
------------------------------------------------------------------------------

▶️ [cmd prompt 명령창 (프롬프트) 실행하는 방법 설명]

https://kkh0977.tistory.com/370

https://blog.naver.com/kkh0977/222239942533


▶️ [업무 이슈] 윈도우 Window PC 환경에서 특정 도메인 접속 불가능 이슈 - 잘못 구성 된 DNS 서버 , hosts 호스트 파일 직접 수정

https://kkh0977.tistory.com/7990

https://blog.naver.com/kkh0977/223865679439?trackingCode=blog_bloghome_searchlist


▶️ [업무 정리] 웹브라우저 접속 실패 및 지연 시 nslookup , ping , tracert 테스트 방법 정리

https://kkh0977.tistory.com/7683

https://blog.naver.com/kkh0977/223746470801?trackingCode=blog_bloghome_searchlist


▶️ [업무 정리] [외부 연결 테스트] Window Cmd ping , telnet 사용해 외부 Connection 연결 테스트 방법

https://kkh0977.tistory.com/7594

https://blog.naver.com/kkh0977/223725875714?trackingCode=blog_bloghome_searchlist

------------------------------------------------------------------------------

[참고 사이트]

https://kkh0977.tistory.com/7683

135. (TWOK/WORK) [업무 정리] 웹브라우저 접속 실패 및 지연 시 nslookup , ping , tracert 테스트 방법 정리

[제 목][업무 정리] 웹브라우저 접속 실패 및 지연 시 nslookup , ping , tracert 테스트 방법 정리 [내 용]------------------------------------------------------------------------------[테스트 사항 및 환경]-------------

kkh0977.tistory.com

36. (cmd/명령어) Window Cmd 명령 프롬프트 네트워크 상태 확인 명령어 종류 정리 - 기본연결 , 포트 및 연결 , DNS 이름해석 , 로컬 네트워크

투케이2K — Mon, 11 May 2026 19:44:20 +0900

[환경 구성 및 요약 설명]

개발 환경 : Window / Cmd / 터미널

설 명 : Window Cmd 명령 프롬프트 네트워크 상태 확인 명령어 종류 정리 - 기본연결 , 포트 및 연결 , DNS 이름해석 , 로컬 네트워크

[소스 코드]

------------------------------------------------------------------------------
[테스트 사항 및 환경]
------------------------------------------------------------------------------

환 경 : 로컬 Window PC / Cmd / 명령 프롬프트


제 목 : Window Cmd 명령 프롬프트 네트워크 상태 확인 명령어 종류 정리 - 기본연결 , 포트 및 연결 , DNS 이름해석 , 로컬 네트워크


사전)   cd (change directory) 명령어 간략 설명 : 

  >> cd 는 Change Directory의 약자로, CMD(명령 프롬프트)에서 현재 작업 중인 디렉터리(폴더)를 변경할 때 사용하는 명령어입니다.

  >> cd 는 '어떤 경로로 이동할 것인가' 를 지정하는 명령어입니다.

  >> 기본 사용 방법 : 

    - 문법 : cd 경로
    - 예시 : cd C:\Wind

------------------------------------------------------------------------------





------------------------------------------------------------------------------
[설 명]
------------------------------------------------------------------------------

-------------------------------------------------
✅ 기본 연결 상태 확인
-------------------------------------------------

✔️ ipconfig : 내 PC의 IP 주소, 게이트웨이, DNS 정보 확인

  >> ipconfig

  >> ipconfig /all

  >> /all : MAC 주소, DHCP 상태 등 상세 정보


✔️ ping : 대상 서버와의 연결 가능 여부 및 지연 시간 확인 / 패킷 손실, 응답 시간(ms) 확인 가능

  >> ping 8.8.8.8

  >> ping google.com


✔️ tracert : 목적지까지의 경로(라우터 경유 정보) 확인 / 네트워크가 어디서 막히는지 분석할 때 유용

  >> tracert google.com


✔️ pathping : ping + tracert 결합 느낌 (지연·손실 분석) / 시간이 조금 오래 걸리지만 상세함

  >> pathping google.com

-------------------------------------------------



-------------------------------------------------
✅ 포트·연결 상태 확인
-------------------------------------------------

✔️ netstat : 현재 열려 있는 포트와 네트워크 연결 상태

  >> netstat -an

  >> netstat -ano

  >> -a : 모든 연결

  >> -n : IP/포트 숫자로 표시

  >> -o : PID 표시 (프로세스 추적 가능)


✔️ tasklist + netstat : PID 기반으로 어떤 프로세스가 포트를 쓰는지 확인

  >> tasklist | find "PID"

-------------------------------------------------



-------------------------------------------------
✅ DNS / 이름 해석 확인
-------------------------------------------------

✔️ nslookup : 도메인 → IP 주소 변환 확인 (DNS 확인) / DNS 서버 문제 분석에 필수

  >> nslookup naver.com

-------------------------------------------------



-------------------------------------------------
✅ 로컬 네트워크 확인
-------------------------------------------------

✔️ arp : 같은 네트워크에 있는 장비들의 IP ↔ MAC 정보

  >> arp -a


✔️ getmac : 내 PC 또는 네트워크 인터페이스의 MAC 주소

  >> getmac


✔️ route : 라우팅 테이블 확인 / VPN, 복수 NIC 환경에서 중요

  >> route print

-------------------------------------------------



-------------------------------------------------
✅ 빠른 점검 예시
-------------------------------------------------

cmd 명령 프롬프트 실행

ipconfig

ping 게이트웨이IP

  >> 게이트웨이 IP 자체가 응답이 없으면, 문제는 거의 항상 내 PC ↔ 공유기(또는 스위치) 구간에 있습니다.

  >> 외부 인터넷 문제가 아니라 내부 네트워크 문제입니다. (랜선 / Wi‑Fi / 네트워크 어댑터 / IP 설정 / 공유기 상태)

nslookup www.google.com

  >>   게이트웨이 OK / 외부 IP OK / 도메인 X → DNS 문제 가능성 높음

-------------------------------------------------

------------------------------------------------------------------------------





------------------------------------------------------------------------------
[참고 사이트]
------------------------------------------------------------------------------

▶️ [cmd prompt 명령창 (프롬프트) 실행하는 방법 설명]

https://kkh0977.tistory.com/370

https://blog.naver.com/kkh0977/222239942533


▶️ [업무 이슈] 윈도우 Window PC 환경에서 특정 도메인 접속 불가능 이슈 - 잘못 구성 된 DNS 서버 , hosts 호스트 파일 직접 수정

https://kkh0977.tistory.com/7990

https://blog.naver.com/kkh0977/223865679439?trackingCode=blog_bloghome_searchlist


▶️ [업무 정리] 웹브라우저 접속 실패 및 지연 시 nslookup , ping , tracert 테스트 방법 정리

https://kkh0977.tistory.com/7683

https://blog.naver.com/kkh0977/223746470801?trackingCode=blog_bloghome_searchlist


▶️ [업무 정리] [외부 연결 테스트] Window Cmd ping , telnet 사용해 외부 Connection 연결 테스트 방법

https://kkh0977.tistory.com/7594

https://blog.naver.com/kkh0977/223725875714?trackingCode=blog_bloghome_searchlist

------------------------------------------------------------------------------

[참고 사이트]

https://kkh0977.tistory.com/7990

158. (TWOK/WORK) [업무 이슈] 윈도우 Window PC 환경에서 특정 도메인 접속 불가능 이슈 - 잘못 구성 된 D

[제 목][업무 이슈] 윈도우 Window PC 환경에서 특정 도메인 접속 불가능 이슈 - 잘못 구성 된 DNS 서버 , hosts 호스트 파일 직접 수정 [내 용]------------------------------------------------------------------------

kkh0977.tistory.com

111. (Web/FrontEnd) [간단 소스] translate 와 meta 메타 태그 사용해 브라우저 자동 번역 기능 차단 설정 방법

투케이2K — Mon, 11 May 2026 19:35:45 +0900

[개발 환경 설정]

개발 툴 : Edit++ / Vscode

개발 언어 : html, css, js, jquery

[소스 코드]

// --------------------------------------------------------------------------------------
[개발 및 테스트 환경]
// --------------------------------------------------------------------------------------

- 개발 환경 : Web


- 개발 툴 : Edit++ / Vscode


- 개발 기술 : FrontEnd / translate / meta


- 사전)   브라우저 인코딩이 깨지거나 변경 되는 이유 간략 정리 : 

  >> Chrome 자동 번역이 끼어드는 경우 : 새 창이 외국어 페이지 (또는 언어 불명) 으로 인식되면 Chrome 이 자동 번역 → 한글이 깨져 보이는 현상이 발생

  >> HTML은 UTF‑8인데 전달 방식에 charset이 없음 : meta charset은 있지만 실제 문서는 UTF‑8로 열리지 않음

// --------------------------------------------------------------------------------------






// --------------------------------------------------------------------------------------
[소스 코드]
// --------------------------------------------------------------------------------------

---------------------------------------------------------
[주요 옵션 설명]
---------------------------------------------------------

✅ <html lang="ko" translate="no"> : 브라우저 번역 요청 방지

✅ <meta charset="utf-8"> : UTF‑8 전달 방식 (Blob 등) , 글자 깨짐 근본 해결

✅ <meta name="google" content="notranslate"> : Chrome 자동 번역 확실히 차단


---------------------------------------------------------
[예시 코드]
---------------------------------------------------------
<!doctype html>
<html lang="ko" translate="no">

<head>
  <meta charset="utf-8">
  <meta name="google" content="notranslate">

  <title>Twok2K</title>
</head>

<body>
  <h3>자동 번역 방지 기능 입니다.</h3>
</body>
</html

// --------------------------------------------------------------------------------------






// --------------------------------------------------------------------------------------
[참고 사이트]
// --------------------------------------------------------------------------------------

▶️ [HTML meta tag 메타 태그 mobile-web-app-capable 사용해 웹앱 URL 주소창 제거 및 전체 화면 설정]

https://kkh0977.tistory.com/7003

https://blog.naver.com/kkh0977/223589024673?trackingCode=blog_bloghome_searchlist


▶️ [간단 소스] HTML meta tag refresh 메타 태그 사용해 특정 URL 주소 이동 수행

https://kkh0977.tistory.com/7294

https://blog.naver.com/kkh0977/223656217865?trackingCode=blog_bloghome_searchlist


▶️ [meta 태그 http-equiv 속성 refresh 사용해 특정 페이지로 리다이렉트(redirect) 수행 실시]

https://kkh0977.tistory.com/2364

https://blog.naver.com/kkh0977/222852455258?trackingCode=blog_bloghome_searchlist


▶️ [HTML meta tag 메타 태그 viewport 뷰포트 사용해 모바일 웹 zoom 줌 확대 , 축소 , 사이즈 고정]

https://kkh0977.tistory.com/6465

https://blog.naver.com/kkh0977/223492312522?trackingCode=blog_bloghome_searchlist

// --------------------------------------------------------------------------------------

[참고 사이트]

https://kkh0977.tistory.com/7003

108. (Web/FrontEnd) HTML meta tag 메타 태그 mobile-web-app-capable 사용해 웹앱 URL 주소창 제거 및 전체 화면

[개발 환경 설정]개발 툴 : Edit++개발 언어 : html, css, js, jquery [소스 코드] [사전 설명]1. mobile-web-app-capable 메타 태그를 사용해 모바일에서 외부 링크 브라우저 표시 수행 시 URL 주소창 제거 및

kkh0977.tistory.com

186. (TWOK/LOGIC) [Aws] WebRTC 기기 입장에서 peerConnection 이벤트 감지를 통해 뷰어 실시간 영상 재생 동시 접속 제한 수 관리 로직

투케이2K — Sat, 9 May 2026 19:57:33 +0900

[로직 정리]

정리 로직 : AWS / WebRTC / peerConnection

제 목 : [Aws] WebRTC 기기 입장에서 peerConnection 이벤트 감지를 통해 뷰어 실시간 영상 재생 동시 접속 제한 수 관리 로직

[설 명]

// --------------------------------------------------------------------------------------
[사전) 설정 및 정보 확인 사항]
// --------------------------------------------------------------------------------------

1. 제 목 : [Aws] WebRTC 기기 입장에서 peerConnection 이벤트 감지를 통해 뷰어 실시간 영상 재생 동시 접속 제한 수 관리 로직


2. 테스트 환경 : Aws / Kvs / WebRTC


3. 사전)   AWS KVS WebRTC 설명 : 

  >> WebRTC 란 웹, 애플리케이션, 디바이스 간 중간자 없이 오디오나 영상 미디어를 포착하고 실시간 스트림할 뿐 아니라, 임의의 데이터도 교환할 수 있도록 하는 기술입니다

  >> WebRTC 는 간단한 API 를 통해 웹 브라우저, 모바일 애플리케이션 및 커넥티드 디바이스 간에 실시간 통신을 활성화할 수 있습니다

  >> WebRTC 주요 용어 : 

    - SDP (Session Description Protocol) : 오디오/비디오 코덱, 해상도, 포트 등 스트리밍 정보를 담은 텍스트 포맷
    - Offer / Answer	: 통신 연결을 협상하기 위한 SDP 메시지 (초기 연결 설정)
    - ICE (Interactive Connectivity Establishment) : NAT/P2P 환경에서도 연결 가능한 경로(IP, 포트 등)를 찾기 위한 기술
    - Candidate : 가능한 연결 경로 (IP + Port 조합)

  >> WebRTC [ICE] 연결 형태 : 

    - Relayed Address : TURN 서버가 패킷 릴레이를 위해 할당하는 주소
    - Server Reflexive Address : NAT 가 매핑한 클라이언트의 공인망 (Public IP, Port)
    - Local Address : 클라이언트의 사설주소 (Private IP, Port)

  >> WebRTC STUN 및 TURN 서버 설명 : 

    - (같은 와이파이 망) STUN 서버는 HOST 를 거쳐 >> Server Reflexive Address 만을 응답하지만,
      (릴레이서버 사용) TURN 서버는 Relayed Address와 Server Reflexive Address 를 모두 응답한다
    - STUN, TURN 서버를 이용해 SDP Answer IP주소 를 취득 >> RTCPeerConnection Remote 연결 수행

  >> WebRTC SDP 오퍼 생성 (뷰어) 및 응답 (마스터) 스트리밍 플로우 : 

    [Viewer → Signaling Server] -- SDP Offer --> [Master] : 뷰어는 마스터로 스트리밍 오퍼 신호 보낸다
    [Master] -- SDP Answer --> [Viewer] : 마스터는 특정 뷰어의 오퍼 신호 확인 후 응답을 보낸다

    [Viewer] -- ICE Candidate --> [Master] : 스트리밍을 할 수 있는 경로 확인
    [Master] -- ICE Candidate --> [Viewer] : 스트리밍을 할 수 있는 경로 확인

    P2P 연결 성립 → 스트리밍 시작


4. 사전)   자바스크립트 AWS Kvs WebRTC 사용 라이브러리 의존성 부여 코드 첨부 :

  <script src="https://code.jquery.com/jquery-latest.min.js"></script>-->

  <script src="https://cdnjs.cloudflare.com/ajax/libs/spin.js/2.3.2/spin.js"></script>
  <script src="https://unpkg.com/sweetalert/dist/sweetalert.min.js"></script>

  <script src="https://unpkg.com/amazon-kinesis-video-streams-webrtc/dist/kvs-webrtc.min.js"></script>
  <script src="https://sdk.amazonaws.com/js/aws-sdk-2.1416.0.min.js"></script>

// --------------------------------------------------------------------------------------






// --------------------------------------------------------------------------------------
[로직 설명]
// --------------------------------------------------------------------------------------

1. ✅ (중요) WebRTC peerConnection.connectionState 상태 간략 정리 : 

  >> peerConnection.connectionState 란 WebRTC 연결 전체 상태 (통합 상태 머신) 감지 콜백 리스너 입니다.

  >> peerConnection.connectionState 는 마스터 입장에서 뷰어의 연결 완료 여부 판단용으로 가장 적합하게 사용할 수 있습니다.

  >> peerConnection.connectionState 주요 상태 : 

    - new 상태 : PeerConnection이 생성됨 / Viewer 가 아직 접속 안 함 상태
    - connecting 상태 : 연결을 구성 중 상태 (ICE candidate 교환, ICE 후보 체크, DTLS Handshake, SRTP 세션 준비)
    - connected 상태 : Viewer 가 연결이 완료되었으며, Video/Audio 전송 시작 및 Viewer가 실제로 화면을 보기 시작
    - disconnected 상태 : 일시적으로 네트워크가 끊김 상태 (재연결 가능성 있음) / disconnected 가 발생 후 연결 된 뷰어가 종료 될 수도 있지만, 잠시 기다리면 다시 connected 로 돌아올 수 있는 상태
    - failed 상태 : 복구 불가한 연결 실패 상태 / Viewer 세션 실패 상태로 PeerConnection 재생성 필요
    - closed 상태 : PeerConnection 이 명시적으로 닫힘 상태 ( ex : pc.close(); ) / Viewer 종료 처리 완료 상태


2. 디바이스 기기는 WebRTC 객체 생성 완료 및 Viewer 의 접속 대기 준비 중 상태


3. 디바이스 기기는 signalingClient.on('sdpOffer') 이벤트 처리 부분에서 peerConnection 이벤트 감지 리스너 생성 및 실제 WebRTC 에 연결 요청 온 뷰어 접속 관리 수행

  // ✅ Viewer 연결 객체 관리를 위한 전역 변수 선언
  const peerConnections = new Map();
  const MAC_CONN_USER = 2; // 뷰어 최대 접속 가능한 사용자 수 정의


  // ✅ [Viewer 의 SDP Offer 수신 대기]

  signalingClient.on('sdpOffer', async (offer, remoteClientId) => {

    // [RTCPeerConnection 만들기]
    const peerConnection = new RTCPeerConnection(config); 

    // [미디어 스트림 추가]
    localStream.getTracks().forEach(track => peerConnection.addTrack(track, localStream)); // [카메라 스트림 트랙에 추가]

    // [peerConnection remoteClientId 지정]
    peerConnection.onicecandidate = event => {
        if (event.candidate) {
            signalingClient.sendIceCandidate(event.candidate, remoteClientId);
        }
    };
              
    // [상대방 오퍼를 내 Remote 에 추가]
    await peerConnection.setRemoteDescription(offer);

    // [Answer 옵션 지정 및 생성]
    const answer = await peerConnection.createAnswer();

    // [Answer 를 내 local 로 저장]
    await peerConnection.setLocalDescription(answer);


    // --------------------------------------------
    // ✅ [RTCPeerConnection 해제 상태 감지를 위한 이벤트 리스너 등록]
    // --------------------------------------------
    // [클로저로 remoteClientId 캡처] : 다중 뷰어 상태 동시 감지
    // --------------------------------------------
    (function(id) {

        peerConnection.onconnectionstatechange = () => {
            console.log(`peerConnection.connectionState 뷰어 Client ID : ${id}`);

            if (peerConnection.connectionState === 'connected') { // 연결 완료 된 상태                
                console.log('[peerConnection Connection Viewer] : [connected]');

                if (peerConnections.size >= MAC_CONN_USER){ // 최대 사용자 인 경우
                                    
                  peerConnections.delete(id); // ✅ 뷰어 삭제 수행

                  peerConnection.close(); // 뷰어 연결 종료 처리

                }
                else {
                  peerConnections.set(id, peerConnection); // ✅ 뷰어 추가 수행

                  // ✅ [SDP Answer 응답 전송]              
                  signalingClient.sendSdpAnswer(peerConnection.localDescription, remoteClientId); // [접속 시도한 기기 아이디를 지정해 줘야함]
                }                
            }


            if (peerConnection == null
                || peerConnection.connectionState === 'disconnected'
                || peerConnection.connectionState === 'failed'
                || peerConnection.connectionState === 'closed') { // 피어 연결 해제 상태 감지

                console.log('[peerConnection Connection Viewer] : [disconnected]');

                // [여기서 리소스 정리 및 UI 업데이트]
                try {
                    peerConnections.delete(id); // ✅ 뷰어 삭제 수행
                }
                catch (error) {
                    console.error("[peerConnection.onconnectionstatechange] : [Exception] : ", error.message);
                }

            }

        };

    })(remoteClientId)

  });

// --------------------------------------------------------------------------------------






// --------------------------------------------------------------------------------------
[참고 사이트]
// --------------------------------------------------------------------------------------

▶️ [업무 이슈] AWS Kvs WebRTC 뷰어 실시간 영상 재생 시 동시 접속 제한 수 초과로 시청자가 접속 가능한 이슈 문의

https://kkh0977.tistory.com/8799

https://blog.naver.com/kkh0977/224274834112


▶️ [Aws Kinesis Video Streams] WebRTC peerConnection.connectionState 뷰어 연결 상태 감지 설명

https://kkh0977.tistory.com/8782

https://blog.naver.com/kkh0977/224260331927


▶️ [android] 안드로이드 AWS KVS WebRTC 실시간 비디오 재생 뷰어 로직 정리 - google-webrtc

https://kkh0977.tistory.com/8771

https://blog.naver.com/kkh0977/224254825523


▶️ [Aws Kinesis Video Streams] IceServer ICE 서버 리스트 와 ICE_CANDIDATE ICE 캔디 데이트 설명 정리

https://kkh0977.tistory.com/8772

https://blog.naver.com/kkh0977/224254833429


▶️ [Aws Kinesis Video Streams] WebRTC onSignalingChange PeerConnection 내부의 SDP 상태 설명

https://kkh0977.tistory.com/8781

https://blog.naver.com/kkh0977/224260325153


▶️ [기능 개선] 자바스크립트 aws kvs webRtc 디바이스 마스터 영상 송출 시 뷰어 다중 접속 설정 - Multi PeerConnection

https://kkh0977.tistory.com/8057

https://blog.naver.com/kkh0977/223898870074?trackingCode=blog_bloghome_searchlist


▶️ [Web/JavaScript] AWS Kvs WebRtc 마스터 비디오 스트림 다중 뷰어 영상 송출

https://kkh0977.tistory.com/8058

https://blog.naver.com/kkh0977/223899701921?trackingCode=blog_bloghome_searchlist

// --------------------------------------------------------------------------------------

[참고 사이트]

https://kkh0977.tistory.com/8799

210. (TWOK/WORK) [업무 이슈] AWS Kvs WebRTC 뷰어 실시간 영상 재생 시 동시 접속 제한 수 초과로 시청자

[제 목]주제 : 투케이2K 업무 정리타이틀 : 투케이 / 2k / 업무 정리제목 : [업무 이슈] AWS Kvs WebRTC 뷰어 실시간 영상 재생 시 동시 접속 제한 수 초과로 시청자가 접속 가능한 이슈 문의 [내

kkh0977.tistory.com

347. [IT 정보] 삼성 갤럭시 스마트폰, 보청기 지원 기능 설정 방법 설명

투케이2K — Sat, 9 May 2026 14:40:11 +0900

[설 명]

주제 : IT 정보

제목 : [IT 정보] 삼성 갤럭시 스마트폰, 보청기 지원 기능 설정 방법 설명

[화면 설명]

[내 용]

// --------------------------------------------------------------------------------------
[개발 및 테스트 환경]
// --------------------------------------------------------------------------------------

- 제목 : [IT 정보] 삼성 갤럭시 스마트폰, 보청기 지원 기능 설정 방법 설명


- 테스트 환경 : 삼성 갤럭시 / 스마트폰 / 보청기


- 사전)   스마트폰 간략 설명 : 

  >> 스마트폰 (Smartphone) 은 전화 기능 + 컴퓨터 기능을 동시에 갖춘 휴대용 디지털 기기입니다.

  >> 스마트폰 (Smartphone) 은 단순히 통화만 하던 휴대폰과 달리, 인터넷·앱·카메라·멀티미디어 등 다양한 기능을 하나로 통합한 것이 핵심입니다.

  >> 주요 운영체제 (OS) : 스마트폰의 두뇌 역할을 하는 소프트웨어입니다.

    - Android → 삼성, LG 등 대부분 제조사
    - iOS → 애플 아이폰 전용

// --------------------------------------------------------------------------------------






// --------------------------------------------------------------------------------------
[방법 설명]
// --------------------------------------------------------------------------------------

1. 설정을 열고 접근성을 선택합니다.


2. 청각 보조에 진입하여 보청기 지원을 선택하세요.


3. 새 보청기 연결선택하여 보청기를 연결해 보세요.


4. ✅ 참고 사항 : 설명된 기능 또는 서비스의 명칭과 진입 경로, 화면 구성은 모델 및 적용된 소프트웨어, 앱 버전 등에 따라 다를 수 있습니다.

  >> 새 보청기 연결 기능은 제조사에서 보청기로 등록한 기기에서만 지원됩니다.

  >> 휴대전화와 보청기 모두 오디오 스트리밍 기능(ASHA)을 지원해야 연결할 수 있습니다.

  >> 보청기의 오디오 스트리밍 기능 (ASHA) 지원 관련 문의 사항은 보청기 제조사에 문의해주세요.

// --------------------------------------------------------------------------------------






// --------------------------------------------------------------------------------------
[참고 사이트]
// --------------------------------------------------------------------------------------

▶️ [삼성 공식 사이트]

https://www.samsungsvc.co.kr/solution/2459877


▶️ [IT 정보] Windows 11 ( 윈도우 11 ) 에서 Bluetooth 블루투스 장치 추가 방법 설명

https://kkh0977.tistory.com/8803

https://blog.naver.com/kkh0977/224275679415


▶️ [IT 정보] 삼성 스마트폰 갤럭시 Galaxy AI 글쓰기 어시스트 설정 방법

https://kkh0977.tistory.com/8778

https://blog.naver.com/kkh0977/224256938252


▶️ [IT 정보] 삼성 스마트폰 갤럭시 무음이나 진동 모드일 때 알람 소리 끄기 설정 방법

https://kkh0977.tistory.com/8748

https://blog.naver.com/kkh0977/224241499813


▶️ [IT 정보] 삼성 스마트폰 갤럭시 Z 플립7 플립수트 케이스의 LED 동작 켜기/끄기 설정하는 방법

https://kkh0977.tistory.com/8744

https://blog.naver.com/kkh0977/224240620599


▶️ [IT 정보] 삼성 스마트폰 갤럭시 S26 가족 기기 공유 - 가족 기기 공유 기능 사용 방법

https://kkh0977.tistory.com/8737

https://blog.naver.com/kkh0977/224238617870

// --------------------------------------------------------------------------------------

[참고 사이트]

https://kkh0977.tistory.com/8803

346. [IT 정보] Windows 11 ( 윈도우 11 ) 에서 Bluetooth 블루투스 장치 추가 방법 설명

[설 명]주제 : IT 정보제목 : [IT 정보] Windows 11 ( 윈도우 11 ) 에서 Bluetooth 블루투스 장치 추가 방법 설명 [화면 설명] [내 용]// ----------------------------------------------------------------------------------

kkh0977.tistory.com